itd-api 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -372,6 +372,55 @@ interface Span {
   id?: string;
 }
 //#endregion
+//#region src/core/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;
+/** Реакция на остаток лимита из заголовков ответа. */
+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/clock.d.ts
 /**
  * Часы, которыми клиент измеряет время и планирует отложенную работу.
@@ -405,6 +454,13 @@ type RetrySafety = (typeof RetrySafety)[keyof typeof RetrySafety];
 interface OperationDefinition {
   readonly method: OperationMethod;
   readonly retrySafety: RetrySafety;
+  /**
+   * Бакет операции. Опущено — операция списывает из `default`.
+   *
+   * Счётчик определяется парой «путь + метод»: `GET /api/users/me` — 40 запросов
+   * в минуту, `PUT` того же пути — 3, `DELETE` — 150.
+   */
+  readonly bucket?: RateLimitBucket;
 }
 /**
  * Каталог встроенных операций.
@@ -420,58 +476,72 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -488,38 +558,47 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -536,10 +615,12 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -548,6 +629,7 @@ declare const OPERATIONS: Readonly<{
   readonly 'users.pins': Readonly<{
     readonly method: "GET";
     readonly retrySafety: "safe";
+    readonly bucket: "users";
   }>;
   readonly 'users.setPin': Readonly<{
     readonly method: "PUT";
@@ -560,10 +642,12 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -584,18 +668,22 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -612,6 +700,7 @@ declare const OPERATIONS: Readonly<{
   readonly 'posts.stats': Readonly<{
     readonly method: "POST";
     readonly retrySafety: "safe";
+    readonly bucket: "posts.stats";
   }>;
   readonly 'posts.byUser': Readonly<{
     readonly method: "GET";
@@ -624,10 +713,12 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -652,30 +743,37 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -692,6 +790,7 @@ declare const OPERATIONS: Readonly<{
   readonly 'notifications.getSettings': Readonly<{
     readonly method: "GET";
     readonly retrySafety: "safe";
+    readonly bucket: "notifications";
   }>;
   readonly 'notifications.updateSettings': Readonly<{
     readonly method: "PUT";
@@ -700,30 +799,37 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -756,10 +862,12 @@ declare const OPERATIONS: Readonly<{
   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";
@@ -802,6 +910,13 @@ declare function isBuiltInOperationId(value: string): value is BuiltInOperationI
 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/runtime.d.ts
 /**
@@ -914,31 +1029,65 @@ interface RetryDecisionContext {
   method: string;
   path: string;
 }
+/** Поправка к одному бакету. */
+interface RateLimitBucketOverride {
+  /** Одновременных запросов внутри бакета. */
+  concurrency?: number | undefined;
+  /** Ёмкость бакета до первого ответа, запросов в минуту. */
+  limit?: number | undefined;
+}
+/** Что известно о запросе в момент выбора бакета. */
+interface RateLimitBucketContext {
+  operationId: OperationId;
+  method: string;
+  path: string;
+}
 /** Настройки ограничения нагрузки на API. */
 interface RateLimitOptions {
-  /** Сколько запросов выполняется одновременно. По умолчанию 6. */
+  /** Одновременных запросов на всех бакетах вместе. По умолчанию 6. */
   concurrency?: number | undefined;
   /** Верхняя граница запросов в секунду. По умолчанию без ограничения. */
   rps?: number | undefined;
   /**
-   * Паузы перед повторами при ответе `429`, мс.
-   * По умолчанию `[1000, 5000, 30000, 60000, 90000]`.
+   * Отдельная очередь на каждый бакет. По умолчанию `true`.
    *
-   * Сервер не сообщает, когда сбросится окно лимита, поэтому паузу приходится подбирать.
-   * Лестница начинается с секунды: если окно почти истекло, работа продолжится почти
-   * сразу, а если лимит исчерпан всерьёз — паузы дорастут до полутора минут.
-   * Когда лестница закончилась, {@link ItdRateLimitError} пробрасывается вызывающему коду.
+   * `false` — одна очередь на направление: её пауза придерживает все запросы разом.
+   * В этом режиме ёмкость отдельного счётчика неизвестна, поэтому `bucketConcurrency`,
+   * `bucketOverrides` и режим `pacing: 'smooth'` не действуют, а исчерпанный остаток
+   * встречается первой ступенью `retryDelays`.
+   */
+  buckets?: boolean | undefined;
+  /**
+   * Одновременных запросов внутри одного бакета. По умолчанию равен `concurrency`.
    *
-   * Этот список не зависит от `retry.attempts`: тот управляет повторами при обрывах
-   * сети и ошибках сервера, где уместен совсем другой темп.
+   * Встроенное исключение — `files.upload` с пределом 1. При `buckets: false` не действует.
    */
-  retryDelays?: readonly number[] | undefined;
+  bucketConcurrency?: number | undefined;
   /**
-   * Тормозить ли очередь по заголовкам ответа. По умолчанию `true`.
+   * Поправки для отдельных бакетов. Неизвестное имя — ошибка конфигурации.
    *
-   * Выключите, если управляете темпом сами.
+   * @example
+   * ```ts
+   * rateLimit: { bucketOverrides: { 'posts.create': { limit: 10 }, feed: { concurrency: 2 } } }
+   * ```
    */
-  respectHeaders?: boolean | undefined;
+  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 {
@@ -1039,10 +1188,14 @@ interface ItdClientOptions {
    * Работает, только когда в `auth` переданы email и пароль. По умолчанию `true`.
    */
   reloginOnRefreshFailure?: boolean | undefined;
-  /** Своя реализация `fetch`: для Deno, React Native, тестов или прокси. */
-  fetch?: typeof fetch | undefined;
-  /** Часы для тайм-аутов, повторов и очередей. Обычно подменяются только в тестах. */
-  clock?: ItdClock | undefined;
+  /**
+   * Значение заголовка `X-Device-Id`, который уходит с каждым запросом.
+   *
+   * Сервер различает по нему записи в списке сессий, поэтому значение должно быть стабильным.
+   * Если не задать, библиотека заведёт идентификатор сама и сохранит его в {@link ItdSession},
+   * так что при постоянном хранилище он переживёт перезапуск процесса.
+   */
+  deviceId?: string | undefined;
   /** Таймаут запроса в мс. По умолчанию 30000 — столько же использует сайт итд.com. `0` снимает ограничение. */
   timeout?: number | undefined;
   /**
@@ -1057,20 +1210,14 @@ interface ItdClientOptions {
   retry?: RetryOptions | false | undefined;
   /** Ограничение нагрузки. `false` отключает очередь. */
   rateLimit?: RateLimitOptions | false | undefined;
-  /** Перехватчики запросов. */
-  hooks?: ClientHooks | undefined;
-  /** Отладочный вывод. `true` — писать в `console`. */
-  logger?: Logger | boolean | undefined;
+  /** Своя реализация `fetch`: для Deno, React Native, тестов или прокси. */
+  fetch?: typeof fetch | undefined;
+  /** Часы для тайм-аутов, повторов и очередей. Обычно подменяются только в тестах. */
+  clock?: ItdClock | undefined;
+  /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
+  mode?: RuntimeMode | undefined;
   /** Заголовки, добавляемые ко всем запросам, — например `User-Agent` для бота. */
   headers?: Record<string, string> | undefined;
-  /**
-   * Значение заголовка `X-Device-Id`, который уходит с каждым запросом.
-   *
-   * Сервер различает по нему записи в списке сессий, поэтому значение должно быть стабильным.
-   * Если не задать, библиотека заведёт идентификатор сама и сохранит его в {@link ItdSession},
-   * так что при постоянном хранилище он переживёт перезапуск процесса.
-   */
-  deviceId?: string | undefined;
   /**
    * Значение заголовка `User-Agent`. `false` — не отправлять его вовсе.
    *
@@ -1079,8 +1226,10 @@ interface ItdClientOptions {
    * В браузере опция не действует — там заголовок менять запрещено.
    */
   userAgent?: string | false | undefined;
-  /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
-  mode?: RuntimeMode | undefined;
+  /** Перехватчики запросов. */
+  hooks?: ClientHooks | undefined;
+  /** Отладочный вывод. `true` — писать в `console`. */
+  logger?: Logger | boolean | undefined;
 }
 /**
  * Namespaces расширений отдельной операции.
@@ -1106,6 +1255,17 @@ interface RequestOptions {
    * интеграциям и осознанному переопределению серверного контракта.
    */
   retrySafety?: RetrySafety | undefined;
+  /**
+   * Имя бакета, из которого списывается запрос.
+   *
+   * Встроенные resources берут его из каталога операций; низкоуровневый вызов без этой
+   * опции попадает в `default`.
+   *
+   * Имя сверяется со встроенной картой — незнакомое отвергается {@link ItdConfigError}
+   * до отправки, независимо от того, включена ли очередь. Своё правило `rateLimit.bucket`
+   * заводит собственное пространство имён и проверку снимает.
+   */
+  rateLimitBucket?: string | undefined;
   /** Настройки подключённых operation extensions, сгруппированные по владельцу. */
   extensions?: RequestExtensions | undefined;
 }
@@ -1165,7 +1325,7 @@ interface OperationRequestOptions extends RawRequestOptions {
 //#endregion
 //#region src/core/version.d.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.6.0";
+declare const LIBRARY_VERSION = "0.7.0";
 //#endregion
 //#region src/core/config.d.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -1653,6 +1813,22 @@ interface ClientPlugin {
   install(api: PluginApi): void | PluginTeardown;
 }
 //#endregion
+//#region src/core/rate-limit.d.ts
+/** Снимок одного бакета. */
+interface RateLimitBucketState {
+  /** Origin, на котором ведётся счётчик. `undefined` — очередь без известного направления. */
+  destination: string | undefined;
+  bucket: string;
+  /** Ёмкость из последнего ответа; `undefined`, пока ответов не было. */
+  limit: number | undefined;
+  /** Остаток из последнего ответа. */
+  remaining: number | undefined;
+  /** Запросов бакета прошло в общую очередь и ещё не завершилось. */
+  active: number;
+  /** Запросов бакета ждёт своей очереди — из-за паузы или предела одновременности. */
+  pending: number;
+}
+//#endregion
 //#region src/models/users.d.ts
 /** Значок-«пин» в профиле — награда или отметка платформы. */
 interface Pin {
@@ -4523,6 +4699,20 @@ declare class ItdClient {
    * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
    */
   request<T = unknown>(options: RawRequestOptions): Promise<T>;
+  /**
+   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.
+   *
+   * Значения берутся из последнего ответа каждого бакета и быстро устаревают: сервер
+   * восстанавливает квоту линейно и границу окна не сообщает. Пустой массив при
+   * `rateLimit: false`. {@link close} снимок сохраняет, {@link dispose} очищает.
+   *
+   * @example
+   * ```ts
+   * const posts = itd.rateLimitState().find((state) => state.bucket === 'posts.create');
+   * if ((posts?.remaining ?? Number.POSITIVE_INFINITY) < 3) await sleep(60_000);
+   * ```
+   */
+  rateLimitState(): RateLimitBucketState[];
   /**
    * Подключает плагин.
    *
@@ -4726,16 +4916,14 @@ interface ItdAccountsOptions extends Omit<ItdClientOptions, 'auth' | 'storage' |
   /** Плагины, подключаемые каждому аккаунту, в том числе добавленному позже. */
   plugins?: readonly ClientPlugin[] | undefined;
   /**
-   * Как делить очередь запросов. По умолчанию `'account'` — своя у каждого.
+   * Как делить очередь запросов. По умолчанию `'shared'` — одна на всех.
    *
-   * Лимиты итд.com считаются по аккаунту, а при работе через разные прокси общая очередь
-   * только мешает. Она нужна в другом случае: когда все аккаунты сидят на одном IP
-   * и упираются в ограничение по адресу, — тогда `'shared'` разводит их запросы во времени
-   * все разом, а не поаккаунтно.
+   * Лимиты итд.com считаются по IP, поэтому аккаунты с одного адреса тратят общую квоту.
+   * `'account'` даёт каждому свою очередь и нужен, когда у аккаунтов разные адреса —
+   * например, при своём прокси у каждого.
    *
-   * Настройки самой очереди берутся из общей опции `rateLimit`. Личный объект `rateLimit`
-   * в этом режиме запрещён, потому что не может изменить уже созданную очередь;
-   * `rateLimit: false` у отдельного аккаунта выводит его из неё.
+   * В режиме `'shared'` настройки очереди берутся из общей опции `rateLimit`; аккаунту
+   * разрешён только `rateLimit: false`, выводящий его из общей очереди.
    */
   rateLimitScope?: RateLimitScope | undefined;
 }
@@ -4743,8 +4931,9 @@ interface ItdAccountsOptions extends Omit<ItdClientOptions, 'auth' | 'storage' |
  * Настройки одного аккаунта. Общее мультихранилище задаёт контейнер, а аккаунт получает
  * свой срез автоматически; остальное — как у `ItdClient`.
  *
- * При `rateLimitScope: 'shared'` объект `rateLimit` задаётся только контейнеру; аккаунту
- * разрешено передать `false`, чтобы не ставить его запросы в общую очередь.
+ * При `rateLimitScope: 'shared'` (умолчание) объект `rateLimit` задаётся только
+ * контейнеру; аккаунту разрешено передать `false`, чтобы не ставить его запросы
+ * в общую очередь.
  */
 type AddAccountOptions = Omit<ItdClientOptions, 'storage'>;
 /** Что можно уточнить при удалении аккаунта. */
@@ -5596,5 +5785,5 @@ interface RenderSpansOptions {
  */
 declare function renderSpans(content: string, spans?: readonly Span[] | null | undefined, options?: RenderSpansOptions): string;
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type AccountEvents, type Actor, type AddAccountOptions, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthResource, type AuthState, type Author, type AutoSpansOptions, type BuilderInput, type BuiltInOperationId, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, type CustomOperationId, DEFAULT_BASE_URL, type DwellEntry, type EnumerableKeyValueStore, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type ForgotPasswordInput, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdAccounts, type ItdAccountsOptions, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdStateError, ItdTimeoutError, ItdValidationError, type KeyValueCodec, type KeyValueStore, type KeyValueStoreKeys, type KeyValueStoreResult, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MultiTokenStorageAdapterOptions, type MyProfile, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationListParams, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitOptions, type RateLimitScope, type RawRequestOptions, RealtimeComposer, type RealtimeContext, type RealtimeContextBase, type RealtimeEngineEvents, type RealtimeErrorBoundary, type RealtimeErrorContext, type RealtimeEvents, type RealtimeFilter, type RealtimeHandler, type RealtimeMiddleware, type RealtimeMiddlewareGroup, type RealtimeMiddlewareLike, type RealtimeMiddlewareObj, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRequest, type RealtimeRequestInput, type RealtimeRouteSelector, type RealtimeRouteTable, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, type RecordKeyValueStoreSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type SignInResult, SignInStatus, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type TokenStorage, type TokenStorageAdapterOptions, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createKeyValueStore, createMultiTokenStorage, createRecordKeyValueStore, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isEnumerableKeyValueStore, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, runRealtimeMiddleware, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso, withCodec, withNamespace };
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type AccountEvents, type Actor, type AddAccountOptions, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthResource, type AuthState, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type EnumerableKeyValueStore, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type ForgotPasswordInput, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdAccounts, type ItdAccountsOptions, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdStateError, ItdTimeoutError, ItdValidationError, type KeyValueCodec, type KeyValueStore, type KeyValueStoreKeys, type KeyValueStoreResult, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MultiTokenStorageAdapterOptions, type MyProfile, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationListParams, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RateLimitScope, type RawRequestOptions, RealtimeComposer, type RealtimeContext, type RealtimeContextBase, type RealtimeEngineEvents, type RealtimeErrorBoundary, type RealtimeErrorContext, type RealtimeEvents, type RealtimeFilter, type RealtimeHandler, type RealtimeMiddleware, type RealtimeMiddlewareGroup, type RealtimeMiddlewareLike, type RealtimeMiddlewareObj, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRequest, type RealtimeRequestInput, type RealtimeRouteSelector, type RealtimeRouteTable, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, type RecordKeyValueStoreSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type SignInResult, SignInStatus, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type TokenStorage, type TokenStorageAdapterOptions, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createKeyValueStore, createMultiTokenStorage, createRecordKeyValueStore, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isEnumerableKeyValueStore, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, runRealtimeMiddleware, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso, withCodec, withNamespace };
 //# sourceMappingURL=index.d.ts.map