Несколько аккаунтов

ItdAccounts управляет именованными клиентами. У каждого аккаунта отдельные tokens, cookie и deviceId, но сессии складываются в одно MultiTokenStorage.

import { ItdAccounts } from 'itd-api';
import { FileMultiTokenStorage } from 'itd-api/node';

const accounts = new ItdAccounts({
  storage: new FileMultiTokenStorage('./.itd-sessions.json'),
  captcha: createCaptchaSolver(),
  rateLimit: { concurrency: 4 },
});

await accounts.restore();

if (!accounts.has('kiow')) {
  accounts.addAccount('kiow', { auth: { email, password } });
}

const itd = accounts.account('kiow');
await itd.posts.create({ content: 'привет' });
await accounts.close();

Имя аккаунта локальное: сервер его не знает и библиотека не нормализует.

Основные операции

Метод	Назначение
addAccount(name, options?)	добавить аккаунт
account(name)	получить обычный ItdClient
restore()	восстановить аккаунты из хранилища
removeAccount(name, { forget })	убрать аккаунт и при необходимости забыть сессию
has(name), names(), size	проверить состав
use(plugin)	подключить плагин существующим и будущим клиентам
on(event, listener)	слушать события всех аккаунтов
close()	временно закрыть все клиенты; контейнер можно использовать снова
dispose()	терминально закрыть контейнер и его клиенты

После dispose() контейнер отзывает storage-срезы и подписки. Добавление и восстановление аккаунтов, новые запросы сохранённых клиентов и подключение плагинов завершаются с ItdStateError. Для временной остановки используйте close().

Общие и личные настройки

Общие опции задаются контейнеру, личные — в addAccount(). headers и services объединяются по ключам.

accounts.addAccount('первый', {
  auth: token1,
  fetch: proxyFetch('socks5://127.0.0.1:1080'),
});

accounts.addAccount('второй', {
  auth: token2,
  fetch: proxyFetch('socks5://127.0.0.1:1081'),
});

auth и deviceId нельзя задавать контейнеру: они принадлежат конкретному аккаунту. Обычный TokenStorage здесь заменён общим MultiTokenStorage, поэтому личный storage в addAccount() также запрещён.

Очереди запросов

Лимиты итд.com считаются по IP, поэтому по умолчанию все аккаунты стоят в одной очереди:

const accounts = new ItdAccounts({
  storage,
  rateLimit: { concurrency: 4, rps: 8 },
});

Параметры очереди в этом режиме задаются контейнеру. Личный rateLimit у аккаунта запрещён, но rateLimit: false выводит конкретный клиент из общей очереди.

Если у каждого аккаунта свой выход в сеть — например, свой fetch через отдельный прокси, — квоты у них независимые, и очереди стоит разделить:

const accounts = new ItdAccounts({ storage, rateLimitScope: 'account' });

Подробнее о лимитах — в справочнике.

Собственное хранилище

Для нескольких аккаунтов нужен key-value backend с перечислением ключей:

import {
  createKeyValueStore,
  createMultiTokenStorage,
  type ItdSession,
  withCodec,
  withNamespace,
} from 'itd-api';

const raw = createKeyValueStore<string>({
  get: async (key) => (await redis.get(key)) ?? undefined,
  set: (key, value) => redis.set(key, value).then(() => undefined),
  delete: (key) => redis.del(key).then(() => undefined),
  keys: (prefix = '') => redis.scanIterator({ MATCH: `${prefix}*` }),
});

const backend = withCodec<ItdSession, string>(withNamespace(raw, 'itd'), {
  encode: JSON.stringify,
  decode: JSON.parse,
});
const storage = createMultiTokenStorage(backend);

События

Контейнер добавляет имя аккаунта в полезную нагрузку:

accounts.on('authError', ({ account, error }) => {
  console.error(`[${account}]`, error);
});

Плагины, подключённые через accounts.use(plugin), применяются ко всем существующим и будущим клиентам. await accounts.unuse(name) отключает плагин у всех, а accounts.pluginNames() показывает фактический общий порядок.

Подключаемые модули

Модуль можно передать контейнеру один раз — он будет установлен и на вручную добавленные, и на восстановленные аккаунты:

const accounts = new ItdAccounts({
  storage,
  features: [
    {
      key: 'probe',
      create: () => probeFeature(),
    },
  ],
});

await accounts.restore();
accounts.addAccount('новый', { auth: token });

create() вызывается отдельно для каждого клиента: состояние API и фоновые ресурсы между аккаунтами не разделяются. Сначала устанавливаются общие плагины, затем модули в порядке массива features, и только после успеха клиент появляется в контейнере. Если фабрика или setup() бросает ошибку, клиент освобождается и аккаунт не публикуется.

Динамического добавления или удаления модулей у уже созданных аккаунтов нет. Базовый ItdAccounts не пытается вывести расширенный тип клиента из произвольного массива; типизированный доступ предоставляет фабрика конкретного продуктового модуля.

События

Каждый аккаунт держит своё SSE-соединение. Не открывайте поток автоматически всем, если уведомления нужны только части аккаунтов.

Запускаемый пример

ITD_TOKENS='бот-1=<accessToken>,бот-2=<accessToken>' \
  node guides/multi-accounts/examples/multi-accounts.mjs

Исходник: examples/multi-accounts.mjs.

Связанные разделы

• Сессии и хранилища
• Справочник ItdAccounts
• Авторизация и сессии
• Конфигурация очередей