Аккаунты — ItdAccounts

Контейнер именованных ItdClient: у каждого аккаунта свой токен, cookie и deviceId, а сессии всех складываются в одно хранилище (MultiTokenStorage). Имя аккаунта выбираете вы; сервер о нём ничего не знает. Полное руководство — Несколько аккаунтов.

new ItdAccounts(options?: ItdAccountsOptions)
createAccounts(options?: ItdAccountsOptions): ItdAccounts   // фабрика

Методы

addAccount(name: string, options?: AddAccountOptions): ItdClient

Заводит аккаунт. Возвращает обычный ItdClient со всеми ресурсами. Хранилище подставляется само — срез общего по имени. auth не обязателен, если сессия уже в хранилище.

account(name: string): ItdClient

Клиент аккаунта. Бросает ItdConfigError, если аккаунта нет.

restore(): Promise<string[]>

Поднимает аккаунты, сессии которых уже лежат в хранилище (после перезапуска — без auth и капчи). Возвращает имена добавленных.

removeAccount(name: string, options?: RemoveAccountOptions): Promise<boolean>

Убирает аккаунт: закрывает клиента и, при forget: true, забывает сессию. Сетевого запроса не делает — для завершения сессии на сервере вызовите itd.auth.logout() до удаления.

has(name: string): boolean
names(): string[]
get size: number
get storage: MultiTokenStorage

Состав контейнера.

use(plugin: ItdPlugin): this
pluginNames(): string[]
hasPlugin(name: string): boolean
unuse(name: string): Promise<boolean>

Подключает плагин всем аккаунтам — и заведённым, и будущим; показывает общий набор или отключает плагин сразу у всех клиентов.

on<K>(event: K, listener): Unsubscribe

Подписка на события авторизации всех аккаунтов сразу.

close(): Promise<void>
dispose(): Promise<void>

close() временно закрывает все аккаунты и останавливает общую очередь, не отключая плагины. dispose() дополнительно вызывает teardown плагинов. await using вызывает dispose().

[Symbol.iterator](): IterableIterator<[string, ItdClient]>

Перебор парами «имя — клиент»: for (const [name, itd] of accounts) { … }.

События (AccountEvents)

Те же, что у одиночного клиента, плюс имя аккаунта:

Событие	Данные
tokens	{ account, accessToken }
signIn	{ account, accessToken }
signOut	{ account }
authError	{ account, error }

Опции

interface ItdAccountsOptions extends Omit<ItdClientOptions, 'auth' | 'storage' | 'deviceId'> {
  storage?: MultiTokenStorage;           // по умолчанию MemoryMultiTokenStorage
  plugins?: readonly ItdPlugin[];        // подключаются каждому аккаунту
  rateLimitScope?: 'account' | 'shared'; // очередь: своя у каждого / общая; по умолчанию 'account'
}

type AddAccountOptions = Omit<ItdClientOptions, 'storage'>;

interface RemoveAccountOptions {
  forget?: boolean;                      // удалить и сохранённую сессию; по умолчанию false
}

rateLimitScope: 'shared' нужен, когда все аккаунты сидят на одном IP и упираются в лимит по адресу. Настройки самой очереди тогда задаются контейнеру опцией rateLimit; аккаунту можно передать только rateLimit: false, чтобы вывести его из общей очереди.