itd-api 0.7.0 → 0.7.2

package/dist/shared/url-DTfZ2toq.d.ts

@@ -0,0 +1,2081 @@
+//#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];
+/**
+ * Минимальное стабильное описание операции, доступное core и плагинам.
+ *
+ * Форма описания принадлежит ядру; заполненный ими каталог — доменному слою.
+ */
+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
+/**
+ * Ёмкость серверных счётчиков частоты, запросов в минуту.
+ *
+ * Таблица действует до первого ответа бакета; дальше ёмкость берётся из заголовка
+ * `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";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.resendOtp': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.refresh': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth.refresh";
+  }>;
+  readonly 'auth.logout': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.forgotPassword': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.resetPassword': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.changePassword': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.sessions': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.revokeSession': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.revokeOtherSessions': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'users.me': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.updateMe': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+    readonly bucket: "users.updateMe";
+  }>;
+  readonly 'users.deactivate': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.restore': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.createProfile': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.checkUsername': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.search': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.whoToFollow': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.topClans': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.follow': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "users.follow";
+  }>;
+  readonly 'users.unfollow': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "users.follow";
+  }>;
+  readonly 'users.followers': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.following': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.followStatus': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.block': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.unblock': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.blocked': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.getPrivacy': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.updatePrivacy': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'users.pins': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "users";
+  }>;
+  readonly 'users.setPin': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'users.removePin': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "feed";
+  }>;
+  readonly 'posts.create': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "posts.create";
+  }>;
+  readonly 'posts.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.update': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'posts.remove': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.restore': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.like': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "posts.like";
+  }>;
+  readonly 'posts.unlike': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "posts.like";
+  }>;
+  readonly 'posts.repost': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "posts.repost";
+  }>;
+  readonly 'posts.unrepost': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "posts.repost";
+  }>;
+  readonly 'posts.pin': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.unpin': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.vote': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.stats': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+    readonly bucket: "posts.stats";
+  }>;
+  readonly 'posts.byUser': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.likedByUser': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.comments': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "posts.comments";
+  }>;
+  readonly 'posts.comment': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "posts.comment";
+  }>;
+  readonly 'comments.replies': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'comments.reply': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.update': Readonly<{
+    readonly method: "PATCH";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'comments.remove': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.restore': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.like': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "comments.like";
+  }>;
+  readonly 'comments.unlike': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "comments.like";
+  }>;
+  readonly 'files.upload': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "files.upload";
+  }>;
+  readonly 'files.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "files.get";
+  }>;
+  readonly 'files.remove': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "files.remove";
+  }>;
+  readonly 'notifications.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "notifications";
+  }>;
+  readonly 'notifications.count': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "notifications";
+  }>;
+  readonly 'notifications.markRead': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'notifications.markReadBatch': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'notifications.markAllRead': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'notifications.getSettings': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "notifications";
+  }>;
+  readonly 'notifications.updateSettings': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'realtime.poll.updates': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "notifications";
+  }>;
+  readonly 'realtime.poll.unread': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "notifications";
+  }>;
+  readonly 'hashtags.search': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "hashtags";
+  }>;
+  readonly 'hashtags.trending': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "hashtags.trending";
+  }>;
+  readonly 'hashtags.posts': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "hashtags";
+  }>;
+  readonly 'search.all': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "search";
+  }>;
+  readonly 'reports.create': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "reports.create";
+  }>;
+  readonly 'subscription.status': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'subscription.pay': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'subscription.setAutoRenewal': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'subscription.bindCard': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'subscription.methods': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'subscription.setDefaultMethod': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'subscription.removeMethod': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'verification.status': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "verification.status";
+  }>;
+  readonly 'verification.submit': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "verification.submit";
+  }>;
+  readonly 'platform.version': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.changelog': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.announcements': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.portal': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'telemetry.dwell': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'telemetry.interaction': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+}>;
+/** Стабильный ID встроенной операции. */
+type BuiltInOperationId = keyof typeof OPERATIONS;
+/** Пользовательская семантическая операция низкоуровневого запроса. */
+type CustomOperationId = `custom:${string}`;
+/** ID любого запроса, видимый transformers и hooks. */
+type OperationId = BuiltInOperationId | FeatureOperationId | CustomOperationId | 'raw';
+/** Проверяет принадлежность ID встроенному каталогу. */
+declare function isBuiltInOperationId(value: string): value is BuiltInOperationId;
+/** HTTP-метод встроенной операции. */
+declare function operationMethod(id: BuiltInOperationId): OperationMethod;
+/** Политика автоматического повтора встроенной операции. */
+declare function operationRetrySafety(id: BuiltInOperationId): RetrySafety;
+/**
+ * Бакет операции.
+ *
+ * `raw` и `custom:*` попадают в `default`; назвать бакет явно позволяет
+ * `rateLimitBucket` у запроса.
+ */
+declare function operationBucket(id: OperationId): RateLimitBucket;
+//#endregion
+//#region src/core/clock.d.ts
+/**
+ * Часы, которыми клиент измеряет время и планирует отложенную работу.
+ *
+ * Своя реализация нужна прежде всего в тестах: она позволяет проверять тайм-ауты,
+ * повторы и переподключение без ожидания в реальном времени.
+ */
+interface ItdClock {
+  /** Текущее время в миллисекундах с начала эпохи Unix. */
+  now(): number;
+  /** Планирует вызов после завершения текущего стека и возвращает функцию отмены. */
+  schedule(callback: () => void, delay: number): () => void;
+}
+/** Системные часы, используемые клиентом по умолчанию. */
+declare const systemClock: ItdClock;
+//#endregion
+//#region src/core/runtime.d.ts
+/**
+ * Как библиотека обращается с cookie.
+ *
+ * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
+ * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
+ * - `auto` — определяется по среде исполнения (значение по умолчанию).
+ */
+declare const RuntimeMode: Readonly<{
+  /** Определяется по среде исполнения. Значение по умолчанию. */
+  readonly Auto: "auto";
+  /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
+  readonly Browser: "browser";
+  /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
+  readonly Server: "server";
+}>;
+type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];
+//#endregion
+//#region src/core/scheduling/pacing.d.ts
+/** Реакция на остаток лимита из заголовков ответа. */
+declare const RateLimitPacing: Readonly<{
+  /** Задержек нет, пока в бакете есть остаток; исчерпанный бакет ждёт `60000 / limit`. */
+  readonly React: "react";
+  /** Ровный темп в пределах минутного лимита: задержки идут с первого запроса. */
+  readonly Smooth: "smooth";
+  /** Остаток на темп не влияет; остаётся пауза после `429`. */
+  readonly Off: "off";
+}>;
+type RateLimitPacing = (typeof RateLimitPacing)[keyof typeof RateLimitPacing];
+//#endregion
+//#region src/core/services.d.ts
+/** Сервис платформы на отдельном домене. */
+interface ServiceDefinition {
+  /** Имя, по которому запрос выбирает сервис: `{ service: 'status' }`. */
+  name: string;
+  /** Базовый URL сервиса. */
+  baseUrl: string;
+  /** Заголовки, добавляемые к каждому запросу сервиса. Заголовки вызова важнее. */
+  headers?: Record<string, string> | undefined;
+  /**
+   * Слать ли заголовок авторизации.
+   *
+   * По умолчанию включено для основного хоста и его поддоменов. Для остальных хостов
+   * авторизацию нужно разрешить явно: `auth: true`.
+   */
+  auth?: boolean | undefined;
+}
+//#endregion
+//#region src/core/url.d.ts
+/** Значение параметра запроса. `undefined` и `null` в строку не попадают. */
+type QueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
+/** Параметры строки запроса. */
+type QueryParams = Record<string, QueryValue>;
+//#endregion
+//#region src/core/options.d.ts
+/** Куда библиотека пишет отладочные сообщения. Совместим с `console`. */
+interface Logger {
+  debug(message: string, ...args: unknown[]): void;
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+}
+/** Настройки повторных попыток. */
+interface RetryOptions {
+  /** Сколько всего попыток, включая первую. По умолчанию 3. */
+  attempts?: number | undefined;
+  /** Базовая пауза в мс, удваивается с каждой попыткой. По умолчанию 500. */
+  baseDelay?: number | undefined;
+  /** Верхняя граница паузы в мс. По умолчанию 30000. */
+  maxDelay?: number | undefined;
+  /** Доля случайного разброса паузы, 0…1. По умолчанию 0.3. */
+  jitter?: number | undefined;
+  /** Своя логика: вернуть `true`, чтобы повторить. Заменяет семантическое правило операции. */
+  shouldRetry?: ((error: unknown, attempt: number, context: RetryDecisionContext) => boolean) | undefined;
+}
+/** Семантика запроса, доступная пользовательской функции `shouldRetry`. */
+interface RetryDecisionContext {
+  operationId: OperationId;
+  retrySafety: RetrySafety;
+  bodyReplayable: boolean;
+  method: string;
+  path: string;
+}
+/** Поправка к одному бакету. */
+interface RateLimitBucketOverride {
+  /** Одновременных запросов внутри бакета. */
+  concurrency?: number | undefined;
+  /** Ёмкость бакета до первого ответа, запросов в минуту. */
+  limit?: number | undefined;
+}
+/** Что известно о запросе в момент выбора бакета. */
+interface RateLimitBucketContext {
+  operationId: OperationId;
+  method: string;
+  path: string;
+}
+/** Настройки ограничения нагрузки на API. */
+interface RateLimitOptions {
+  /** Одновременных запросов на всех бакетах вместе. По умолчанию 6. */
+  concurrency?: number | undefined;
+  /** Верхняя граница запросов в секунду. По умолчанию без ограничения. */
+  rps?: number | undefined;
+  /**
+   * Отдельная очередь на каждый бакет. По умолчанию `true`.
+   *
+   * `false` — одна очередь на направление: её пауза придерживает все запросы разом.
+   * В этом режиме ёмкость отдельного счётчика неизвестна, поэтому `bucketConcurrency`,
+   * `bucketOverrides` и режим `pacing: 'smooth'` не действуют, а исчерпанный остаток
+   * встречается первой ступенью `retryDelays`.
+   */
+  buckets?: boolean | undefined;
+  /**
+   * Одновременных запросов внутри одного бакета. По умолчанию равен `concurrency`.
+   *
+   * Встроенное исключение — `files.upload` с пределом 1. При `buckets: false` не действует.
+   */
+  bucketConcurrency?: number | undefined;
+  /**
+   * Поправки для отдельных бакетов. Неизвестное имя — ошибка конфигурации.
+   *
+   * @example
+   * ```ts
+   * rateLimit: { bucketOverrides: { 'posts.create': { limit: 10 }, feed: { concurrency: 2 } } }
+   * ```
+   */
+  bucketOverrides?: Record<string, RateLimitBucketOverride> | undefined;
+  /**
+   * Своё правило выбора бакета. `undefined` из функции отдаёт запрос встроенной карте.
+   *
+   * Возвращайте конечное множество имён: каждое заводит свою очередь.
+   */
+  bucket?: ((request: RateLimitBucketContext) => string | undefined) | undefined;
+  /** Реакция на остаток, см. {@link RateLimitPacing}. По умолчанию `'react'`. */
+  pacing?: RateLimitPacing | undefined;
+  /**
+   * Паузы перед повторами при ответе `429`, мс.
+   * По умолчанию `[1000, 5000, 30000, 60000, 90000]`.
+   *
+   * После последней ступени {@link ItdRateLimitError} пробрасывается вызывающему коду.
+   * От `retry.attempts` не зависит: `retry: false` лестницу не отключает.
+   */
+  retryDelays?: readonly number[] | undefined;
+}
+/** Данные о запросе, доступные хукам. */
+interface RequestContext {
+  /** Стабильная семантическая операция; `raw` у низкоуровневого вызова без явного ID. */
+  operationId: OperationId;
+  method: string;
+  /** Путь без базового URL, например `/api/posts`. */
+  path: string;
+  /** Итоговый URL со строкой запроса. */
+  url: string;
+  headers: Headers;
+  /** Номер попытки, начиная с 1. */
+  attempt: number;
+}
+/** Данные об успешном ответе. */
+interface ResponseContext extends RequestContext {
+  status: number;
+  /** Длительность запроса в мс. */
+  duration: number;
+  /** Отдельная копия ответа: её тело можно прочитать, не мешая разбору внутри SDK. */
+  response: Response;
+}
+/** Данные об ошибке запроса. */
+interface ErrorContextHook extends RequestContext {
+  duration: number;
+  error: unknown;
+}
+/** Данные о предстоящем повторе. */
+interface RetryContext extends RequestContext {
+  error: unknown;
+  /** Пауза перед следующей попыткой в мс. */
+  delay: number;
+}
+/**
+ * Перехватчики жизненного цикла запроса.
+ *
+ * Вызываются последовательно; исключение внутри хука прервёт запрос, поэтому свою логику
+ * лучше оборачивать в `try`.
+ */
+interface ClientHooks {
+  /** Перед отправкой. Можно дописать заголовки — объект `headers` изменяемый. */
+  onRequest?(context: RequestContext): void | Promise<void>;
+  /** После успешного ответа, до разбора тела. */
+  onResponse?(context: ResponseContext): void | Promise<void>;
+  /** При любой ошибке запроса, включая те, что будут повторены. */
+  onError?(context: ErrorContextHook): void | Promise<void>;
+  /** Перед паузой между попытками. */
+  onRetry?(context: RetryContext): void | Promise<void>;
+}
+/**
+ * Настройки исполнения запросов: куда ходить, как долго ждать и чем представляться.
+ *
+ * Всё, что нужно generic-ядру и ничего сверх того. Авторизация и сессия описаны отдельно
+ * в {@link SessionOptions}, а полный набор опций клиента их объединяет.
+ *
+ * Все поля допускают явный `undefined`, чтобы можно было передавать значения, которых
+ * может не быть, — например `new ItdClient({ timeout: process.env.TIMEOUT })`.
+ */
+interface RuntimeOptions {
+  /**
+   * Базовый URL API. По умолчанию `https://xn--d1ah4a.com`.
+   *
+   * Укажите здесь адрес своего прокси, если работаете из браузера: CORS для сторонних
+   * источников на итд.com, скорее всего, не настроен.
+   */
+  baseUrl?: string | undefined;
+  /**
+   * Сервисы платформы на отдельных доменах.
+   *
+   * Ключ — имя сервиса, значение — базовый URL или определение целиком. Имя встроенного
+   * сервиса задаёт его хост; встроен один — `status`.
+   *
+   * `auth` у встроенного сервиса наследуется, у нового выводится по хосту: токен уходит
+   * основному хосту и его поддоменам, остальным — по явному `auth: true`.
+   *
+   * @example
+   * ```ts
+   * const itd = new ItdClient({
+   *   services: {
+   *     status: 'https://my-proxy.example/status',
+   *     pb: { baseUrl: 'https://pbapi.xn--d1ah4a.com', headers: { Referer: 'https://pixel.xn--d1ah4a.com/' } },
+   *   },
+   * });
+   * ```
+   */
+  services?: Record<string, string | Omit<ServiceDefinition, 'name'>> | undefined;
+  /** Таймаут запроса в мс. По умолчанию 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.2";
+//#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;
+}
+/**
+ * Что конвейер запросов спрашивает у авторизации.
+ *
+ * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про
+ * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым
+ * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.
+ *
+ * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —
+ * {@link bearerToken}, {@link tokenProvider} и {@link anonymousAuth}.
+ */
+interface AuthProvider {
+  /**
+   * Текущий токен доступа.
+   *
+   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен
+   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.
+   */
+  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` не восстанавливается.
+ *
+ * @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;
+  /**
+   * **Эмодзи, а не картинка.**
+   *
+   * На итд.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;
+}
+/**
+ * Состояние авторизации — ответ `GET /api/profile`.
+ *
+ * Endpoint доступен без сессии: в этом случае `authenticated` равен `false`,
+ * а `user` — `null`.
+ */
+interface AuthState {
+  /** Есть ли действующая сессия. */
+  authenticated: boolean;
+  /** Заблокирован ли текущий аккаунт. */
+  banned: boolean;
+  /** Текущий пользователь либо `null` без действующей сессии. */
+  user: MyProfile | null;
+}
+/**
+ * Чужой профиль — ответ `GET /api/users/{id|username}`.
+ *
+ * Вместо своей подписки содержит связь с вами и присутствие.
+ */
+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;
+}
+/**
+ * Результат подписки на пользователя.
+ *
+ * @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;
+}
+//#endregion
+//#region src/models/notifications.d.ts
+/**
+ * Уведомление в единой форме.
+ *
+ * REST-список и SSE-поток отдают уведомления по-разному — разные имена типов, разные имена
+ * полей, один участник против массива. Библиотека приводит оба вида к этой структуре,
+ * поэтому объекты из `itd.notifications.list()` и из потока можно складывать в один список.
+ *
+ * Исходные данные не теряются: серверное имя типа остаётся в {@link rawType},
+ * а весь необработанный объект — в {@link raw}.
+ */
+interface Notification {
+  id: string;
+  /** Канонический тип. Старые имена (`like`, `comment`) приведены к новым. */
+  type: NotificationType;
+  /** Имя типа в том виде, в каком его прислал сервер. */
+  rawType: string;
+  /** Объект события: пост, комментарий, пользователь. */
+  entityId: string | null;
+  /** Пост, которому принадлежит комментарий, если событие о комментарии. */
+  parentEntityId: string | null;
+  /** Прочитано ли уведомление. */
+  isRead: boolean;
+  /** Кто совершил действие. Для схлопнутых уведомлений — несколько человек. */
+  actors: Actor[];
+  /** Сколько участников схлопнуто в одно уведомление. Минимум 1. */
+  count: number;
+  /** Текст или заголовок объекта события. */
+  preview: string | null;
+  /** Ссылка перехода, предложенная сервером. Обычно точнее её `resolveNotificationUrl()`. */
+  clickUrl?: string;
+  createdAt: IsoDate;
+  /** Когда уведомление изменилось — например было прочитано. */
+  updatedAt: IsoDate;
+  /** Исходный объект как он пришёл от сервера. */
+  raw: unknown;
+}
+/**
+ * Настройки уведомлений.
+ *
+ * Сервер отдаёт плоский объект, но исторически знает два набора имён для одних и тех же
+ * настроек (`likes` и `reactions`, `comments` и `replies`). При сохранении библиотека
+ * отправляет оба, при чтении принимает любой.
+ */
+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;
+  /**
+   * Актуальное число непрочитанных, если сервер его сообщил.
+   *
+   * Клиент не увеличивает счётчик сам: значение приходит с сервера.
+   */
+  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/core/errors.d.ts
+/** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */
+declare const ITD_ERROR: unique symbol;
+/**
+ * Категория ошибки. Определяет, какие поля у неё есть.
+ *
+ * Значение, а не только тип: категорию нужно с чем-то сравнивать в рантайме.
+ */
+declare const ItdErrorKind: Readonly<{
+  /** Сервер ответил статусом ≥ 400. */
+  readonly Api: "api";
+  /** Запрос не дошёл до сервера. */
+  readonly Network: "network";
+  /** Истёк таймаут запроса. */
+  readonly Timeout: "timeout";
+  /** Запрос отменён через `AbortSignal`. */
+  readonly Abort: "abort";
+  /** Операция невозможна в текущем состоянии объекта. */
+  readonly State: "state";
+  /** Не удалось получить или подготовить содержимое вложения. */
+  readonly File: "file";
+  /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */
+  readonly Config: "config";
+}>;
+type ItdErrorKind = (typeof ItdErrorKind)[keyof typeof ItdErrorKind];
+/**
+ * Разновидность ошибки API — то же, что класс ошибки, но в виде данных.
+ *
+ * Существует потому, что `instanceof` подводит, когда в дереве зависимостей оказались
+ * две копии пакета или смешаны сборки ESM и CJS: классы тогда разные, хотя ошибка та же.
+ * Проверки {@link isItdValidationError} и соседние опираются на это поле, а не на класс.
+ */
+declare const ItdApiErrorKind: Readonly<{
+  /** Ни одна из специализаций не подошла. */
+  readonly Generic: "generic";
+  readonly Validation: "validation";
+  readonly Auth: "auth";
+  readonly Forbidden: "forbidden";
+  readonly NotFound: "not_found";
+  readonly Conflict: "conflict";
+  readonly RateLimit: "rate_limit";
+  readonly PhoneVerification: "phone_verification";
+  readonly Server: "server";
+}>;
+type ItdApiErrorKind = (typeof ItdApiErrorKind)[keyof typeof ItdApiErrorKind];
+/** Ошибки по полям формы: `{ email: ['уже занят'] }`. */
+type ItdFieldErrors = Record<string, string[]>;
+/**
+ * Базовый класс всех ошибок библиотеки.
+ *
+ * Ловить его имеет смысл, чтобы отделить проблемы обращения к итд.com от прочих исключений.
+ * Для разбора конкретной причины используйте {@link isItdApiError} и поле {@link ItdApiError.code}.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await itd.posts.like(id);
+ * } catch (e) {
+ *   if (isItdError(e)) console.error('итд.com:', e.message);
+ *   else throw e;
+ * }
+ * ```
+ */
+declare class ItdError extends Error {
+  /** @internal */
+  readonly [ITD_ERROR]: true;
+  /** Категория ошибки. */
+  readonly kind: ItdErrorKind;
+  constructor(kind: ItdErrorKind, message: string, options?: {
+    cause?: unknown;
+  });
+}
+/** Параметры конструктора {@link ItdApiError}. */
+interface ItdApiErrorInit {
+  /** HTTP-статус ответа. */
+  status: number;
+  /** Строковый код ошибки из тела ответа. */
+  code: ItdErrorCode;
+  /** Человекочитаемое сообщение. */
+  message: string;
+  /** Расширенное описание, если сервер его прислал. */
+  detail?: string | undefined;
+  /** Заголовок ошибки, если сервер его прислал. */
+  title?: string | undefined;
+  /** Ошибки по конкретным полям (сведены из `errors` и `violations`). */
+  fieldErrors?: ItdFieldErrors | undefined;
+  /** Идентификатор запроса из заголовков ответа, если есть. */
+  requestId?: string | undefined;
+  /** HTTP-метод запроса. */
+  method: string;
+  /** Путь запроса без базового URL. */
+  path: string;
+  /** Тело ответа как оно пришло — на случай, если документация разошлась с реальностью. */
+  raw: unknown;
+  /** Сам объект ответа. Тело уже прочитано. */
+  response?: Response | undefined;
+  /** Значение `Retry-After` в миллисекундах, если заголовок был. */
+  retryAfter?: number | undefined;
+  /** Сколько запросов разрешено в окне (`x-ratelimit-limit`). */
+  rateLimit?: number | undefined;
+  /** Сколько запросов осталось в окне (`x-ratelimit-remaining`). */
+  rateLimitRemaining?: number | undefined;
+}
+/**
+ * Ошибка, возвращённая сервером итд.com (HTTP-статус ≥ 400).
+ *
+ * API отдаёт ошибки в двух разных формах — `{ error: { … } }` и `{ code, message, violations }`.
+ * Библиотека сводит обе к этому классу, поэтому разбирать форму ответа вручную не нужно.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await itd.users.updateMe({ username: 'занятое_имя' });
+ * } catch (e) {
+ *   if (e instanceof ItdValidationError) {
+ *     console.log(e.fieldErrors.username); // ['Имя уже занято']
+ *   }
+ * }
+ * ```
+ */
+declare class ItdApiError extends ItdError {
+  /**
+   * Разновидность ошибки: та же информация, что и класс, но пригодная для сравнения.
+   *
+   * Позволяет разбирать ошибку через `switch`, а проверкам вроде {@link isItdAuthError} —
+   * работать даже когда в проекте оказались две копии библиотеки.
+   */
+  readonly apiKind: ItdApiErrorKind;
+  /** HTTP-статус ответа. */
+  readonly status: number;
+  /** Строковый код ошибки, например `VALIDATION_ERROR`. */
+  readonly code: ItdErrorCode;
+  /** Расширенное описание, если сервер его прислал. */
+  readonly detail: string | undefined;
+  /** Заголовок ошибки, если сервер его прислал. */
+  readonly title: string | undefined;
+  /** Ошибки по полям. Пустой объект, если сервер их не прислал. */
+  readonly fieldErrors: ItdFieldErrors;
+  /** Идентификатор запроса из заголовков ответа. */
+  readonly requestId: string | undefined;
+  /** HTTP-метод запроса. */
+  readonly method: string;
+  /** Путь запроса без базового URL. */
+  readonly path: string;
+  /** Тело ответа как оно пришло. */
+  readonly raw: unknown;
+  /** Объект ответа. Тело уже прочитано и повторно прочитано быть не может. */
+  readonly response: Response | undefined;
+  /** Пауза из заголовка `Retry-After` в миллисекундах. Сервер итд.com его не присылает. */
+  readonly retryAfter: number | undefined;
+  /**
+   * Сколько запросов разрешено в окне — заголовок `x-ratelimit-limit`.
+   *
+   * Времени сброса окна сервер не сообщает, поэтому точный момент повтора неизвестен.
+   */
+  readonly rateLimit: number | undefined;
+  /** Сколько запросов осталось в окне — заголовок `x-ratelimit-remaining`. */
+  readonly rateLimitRemaining: number | undefined;
+  /**
+   * @param apiKind разновидность; подставляется подклассами, снаружи задавать не нужно
+   */
+  constructor(init: ItdApiErrorInit, apiKind?: ItdApiErrorKind);
+  /**
+   * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.
+   *
+   * @example
+   * ```ts
+   * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();
+   * ```
+   */
+  hasCode(...codes: ItdErrorCode[]): boolean;
+  /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */
+  get isRetryable(): boolean;
+}
+/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */
+declare class ItdValidationError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/** `401` — токен отсутствует, истёк или отозван. */
+declare class ItdAuthError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/** `403` — доступ запрещён либо действие ограничено настройками приватности. */
+declare class ItdForbiddenError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/** `404` — сущность не найдена. */
+declare class ItdNotFoundError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/** `409` — сущность уже существует. */
+declare class ItdConflictError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/**
+ * `429` — превышен лимит запросов.
+ *
+ * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}
+ * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.
+ */
+declare class ItdRateLimitError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/**
+ * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).
+ *
+ * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.
+ */
+declare class ItdPhoneVerificationError extends ItdApiError {
+  /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */
+  readonly verificationUrl: string | undefined;
+  constructor(init: ItdApiErrorInit & {
+    userId?: string | undefined;
+  });
+}
+/** `5xx` — ошибка на стороне сервера. */
+declare class ItdServerError extends ItdApiError {
+  constructor(init: ItdApiErrorInit);
+}
+/** Причина ошибки получения вложения. */
+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()` и не может выполнять
+ * новые запросы или создавать realtime-потоки.
+ */
+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/notifications/text.d.ts
+/**
+ * Собирает текст уведомления на русском.
+ *
+ * Повторяет формулировки сайта итд.com. Для неизвестного типа возвращает
+ * «Новое уведомление» — библиотека не выдумывает текст, которого нет.
+ *
+ * @example
+ * ```ts
+ * formatNotificationText(notification);
+ * // 'Аня и ещё 2 оценили ваш пост'
+ * ```
+ */
+declare function formatNotificationText(notification: Notification): string;
+//#endregion
+//#region src/notifications/type-map.d.ts
+/**
+ * Приводит имя типа к каноническому.
+ *
+ * Неизвестное значение возвращается без изменений, чтобы не менять смысл нового типа
+ * уведомления на другой.
+ *
+ * @example
+ * ```ts
+ * canonicalNotificationType('like');           // 'post_reaction'
+ * canonicalNotificationType('post_reaction');  // 'post_reaction'
+ * canonicalNotificationType('новое_событие');  // 'новое_событие'
+ * ```
+ */
+declare function canonicalNotificationType(rawType: string): NotificationType;
+/**
+ * Известен ли библиотеке этот тип уведомления.
+ *
+ * Полезно, чтобы решить, показывать ли уведомление, для которого нет своего оформления.
+ */
+declare function isKnownNotificationType(type: string): boolean;
+//#endregion
+//#region src/notifications/url.d.ts
+/**
+ * Вычисляет адрес, на который ведёт уведомление.
+ *
+ * Возвращает путь внутри сайта — без домена, чтобы его можно было передать роутеру
+ * приложения. Поле `clickUrl` от сервера используется только как запасной вариант:
+ * вычисленный путь точнее, поскольку учитывает родительский пост у комментариев.
+ *
+ * @example
+ * ```ts
+ * const url = resolveNotificationUrl(notification);
+ * // '/@nowkie/post/9f1c…?comment=2b7e…'
+ * ```
+ */
+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 _, RetrySafety as _n, 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, OperationMethod as gn, IncidentKind as gt, ItdFileError as h, FeatureOperationId 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-DTfZ2toq.d.ts.map