itd-api 0.7.0 → 0.7.2

package/dist/shared/multi-storage--yTEqiod.cjs

@@ -0,0 +1,150 @@
+const require_errors = require("./errors-DfU8M5eS.cjs");
+const require_cookies = require("./cookies-DZwFq6kr.cjs");
+const require_storage = require("./storage-BPJR_k4-.cjs");
+//#region src/session/multi-storage.ts
+/**
+* Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
+* отдельный `ItdClient`, который про соседние аккаунты ничего не знает.
+*/
+function scopedTokenStorage(storage, account) {
+	return {
+		get: () => storage.get(account),
+		set: (session) => storage.set(account, session),
+		clear: () => storage.clear(account)
+	};
+}
+/**
+* Можно ли восстановить авторизованный аккаунт из записи.
+*
+* Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет
+* выполнить ни одного авторизованного запроса.
+*
+* @internal
+*/
+function isRestorableSession(session) {
+	if (!session) return false;
+	if (session.accessToken || session.refreshToken) return true;
+	const jar = new require_cookies.CookieJar();
+	jar.deserialize(session.cookies);
+	return jar.has(require_cookies.AUTH_FLAG_COOKIE);
+}
+/** @internal */
+function controlledTokenStorage(storage, account) {
+	let revoked = false;
+	const pending = /* @__PURE__ */ new Set();
+	const mutate = (operation) => {
+		if (revoked) return Promise.resolve();
+		const promise = Promise.resolve().then(operation);
+		pending.add(promise);
+		promise.then(() => pending.delete(promise), () => pending.delete(promise));
+		return promise;
+	};
+	return {
+		storage: {
+			get: () => revoked ? null : storage.get(account),
+			set: (session) => mutate(() => storage.set(account, session)),
+			clear: () => mutate(() => storage.clear(account))
+		},
+		revoke() {
+			revoked = true;
+		},
+		async drain() {
+			await Promise.all([...pending]);
+		}
+	};
+}
+/**
+* Мультихранилище в памяти процесса — вариант по умолчанию.
+*
+* Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`
+* из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
+*/
+var MemoryMultiTokenStorage = class {
+	#store = new require_storage.MemoryKeyValueStore();
+	constructor(initial) {
+		for (const [account, session] of Object.entries(initial ?? {})) this.#store.set(accountKey(account), require_storage.copySession(session));
+	}
+	get(account) {
+		const session = this.#store.get(accountKey(account));
+		return session ? require_storage.copySession(session) : null;
+	}
+	set(account, session) {
+		this.#store.set(accountKey(account), require_storage.copySession(session));
+	}
+	clear(account) {
+		this.#store.delete(accountKey(account));
+	}
+	accounts() {
+		return this.#store.keys(ACCOUNT_KEY_PREFIX).flatMap((key) => readAccountName(key.slice(ACCOUNT_KEY_PREFIX.length)) ?? []);
+	}
+};
+const ACCOUNT_KEY_PREFIX = "accounts/";
+function accountKey(account) {
+	return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;
+}
+/** Читает имя аккаунта из ключа. `undefined` — ключ не декодируется и запись пропускается. */
+function readAccountName(encoded) {
+	try {
+		return decodeURIComponent(encoded);
+	} catch {
+		console.warn(`[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`);
+		return;
+	}
+}
+/**
+* Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.
+*
+* Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому
+* запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.
+*/
+function createMultiTokenStorage(store, options = {}) {
+	const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;
+	if (typeof prefix !== "string") throw new require_errors.ItdConfigError("prefix MultiTokenStorage должен быть строкой");
+	const backend = require_storage.createKeyValueStore(store);
+	if (!require_storage.isEnumerableKeyValueStore(backend)) throw new require_errors.ItdConfigError("MultiTokenStorage требует KeyValueStore с методом keys()");
+	const key = (account) => `${prefix}${encodeURIComponent(account)}`;
+	return {
+		async get(account) {
+			const session = await backend.get(key(account));
+			return session ? require_storage.copySession(session) : null;
+		},
+		set: (account, session) => backend.set(key(account), require_storage.copySession(session)),
+		clear: (account) => backend.delete(key(account)),
+		async accounts() {
+			return (await require_storage.collectKeyValueStoreKeys(backend, prefix)).flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "MemoryMultiTokenStorage", {
+	enumerable: true,
+	get: function() {
+		return MemoryMultiTokenStorage;
+	}
+});
+Object.defineProperty(exports, "controlledTokenStorage", {
+	enumerable: true,
+	get: function() {
+		return controlledTokenStorage;
+	}
+});
+Object.defineProperty(exports, "createMultiTokenStorage", {
+	enumerable: true,
+	get: function() {
+		return createMultiTokenStorage;
+	}
+});
+Object.defineProperty(exports, "isRestorableSession", {
+	enumerable: true,
+	get: function() {
+		return isRestorableSession;
+	}
+});
+Object.defineProperty(exports, "scopedTokenStorage", {
+	enumerable: true,
+	get: function() {
+		return scopedTokenStorage;
+	}
+});
+
+//# sourceMappingURL=multi-storage--yTEqiod.cjs.map

package/dist/shared/multi-storage--yTEqiod.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-storage--yTEqiod.cjs","names":["CookieJar","AUTH_FLAG_COOKIE","#store","MemoryKeyValueStore","copySession","ItdConfigError","createKeyValueStore","isEnumerableKeyValueStore","collectKeyValueStoreKeys"],"sources":["../../src/session/multi-storage.ts"],"sourcesContent":["import { AUTH_FLAG_COOKIE, CookieJar } from '../core/cookies.js';\nimport { ItdConfigError } from '../core/errors.js';\nimport {\n  collectKeyValueStoreKeys,\n  createKeyValueStore,\n  type EnumerableKeyValueStore,\n  isEnumerableKeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/key-value-store.js';\nimport { copySession, type ItdSession, type TokenStorage } from './storage.js';\n\n/**\n * Хранилище сессий нескольких аккаунтов.\n *\n * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:\n * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,\n * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:\n * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения\n * на длину ключа остаются за адаптером.\n *\n * Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Хранилище поверх enumerable Redis backend\n * ```ts\n * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport interface MultiTokenStorage {\n  /** Прочитать сессию аккаунта. `null`, если её нет. */\n  get(account: string): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию аккаунта целиком. */\n  set(account: string, session: ItdSession): void | Promise<void>;\n  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(account: string): void | Promise<void>;\n  /**\n   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов\n   * после перезапуска процесса.\n   *\n   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,\n   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.\n   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после\n   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.\n   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть\n   * доступны по имени.\n   */\n  accounts(): readonly string[] | Promise<readonly string[]>;\n}\n\n/**\n * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает\n * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.\n */\nexport function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage {\n  return {\n    get: () => storage.get(account),\n    set: (session) => storage.set(account, session),\n    clear: () => storage.clear(account),\n  };\n}\n\n/**\n * Можно ли восстановить авторизованный аккаунт из записи.\n *\n * Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет\n * выполнить ни одного авторизованного запроса.\n *\n * @internal\n */\nexport function isRestorableSession(session: ItdSession | null): session is ItdSession {\n  if (!session) return false;\n  if (session.accessToken || session.refreshToken) return true;\n\n  const jar = new CookieJar();\n  jar.deserialize(session.cookies);\n  return jar.has(AUTH_FLAG_COOKIE);\n}\n\n/**\n * Управляемый срез хранилища для клиента аккаунта.\n *\n * После `revoke()` новые записи не доходят до общего хранилища, а `drain()` позволяет\n * дождаться уже начатых. Так удалённый клиент или завершившийся с опозданием refresh\n * не воскресят сессию после `removeAccount(..., { forget: true })`.\n *\n * @internal\n */\nexport interface ControlledTokenStorage {\n  storage: TokenStorage;\n  revoke(): void;\n  drain(): Promise<void>;\n}\n\n/** @internal */\nexport function controlledTokenStorage(\n  storage: MultiTokenStorage,\n  account: string,\n): ControlledTokenStorage {\n  let revoked = false;\n  const pending = new Set<Promise<void>>();\n\n  const mutate = (operation: () => void | Promise<void>): Promise<void> => {\n    if (revoked) return Promise.resolve();\n\n    const promise = Promise.resolve().then(operation);\n    pending.add(promise);\n    void promise.then(\n      () => pending.delete(promise),\n      () => pending.delete(promise),\n    );\n    return promise;\n  };\n\n  return {\n    storage: {\n      get: () => (revoked ? null : storage.get(account)),\n      set: (session) => mutate(() => storage.set(account, session)),\n      clear: () => mutate(() => storage.clear(account)),\n    },\n    revoke() {\n      revoked = true;\n    },\n    async drain() {\n      await Promise.all([...pending]);\n    },\n  };\n}\n\n/**\n * Мультихранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`\n * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.\n */\nexport class MemoryMultiTokenStorage implements MultiTokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: Readonly<Record<string, ItdSession>> | null) {\n    for (const [account, session] of Object.entries(initial ?? {})) {\n      this.#store.set(accountKey(account), copySession(session));\n    }\n  }\n\n  get(account: string): ItdSession | null {\n    const session = this.#store.get(accountKey(account));\n    return session ? copySession(session) : null;\n  }\n\n  set(account: string, session: ItdSession): void {\n    this.#store.set(accountKey(account), copySession(session));\n  }\n\n  clear(account: string): void {\n    this.#store.delete(accountKey(account));\n  }\n\n  accounts(): string[] {\n    return this.#store\n      .keys(ACCOUNT_KEY_PREFIX)\n      .flatMap((key) => readAccountName(key.slice(ACCOUNT_KEY_PREFIX.length)) ?? []);\n  }\n}\n\nconst ACCOUNT_KEY_PREFIX = 'accounts/';\n\nfunction accountKey(account: string): string {\n  return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;\n}\n\n/** Читает имя аккаунта из ключа. `undefined` — ключ не декодируется и запись пропускается. */\nfunction readAccountName(encoded: string): string | undefined {\n  try {\n    return decodeURIComponent(encoded);\n  } catch {\n    console.warn(\n      `[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`,\n    );\n    return undefined;\n  }\n}\n\n/** Настройки доменного адаптера нескольких сессий. */\nexport interface MultiTokenStorageAdapterOptions {\n  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */\n  prefix?: string | undefined;\n}\n\n/**\n * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.\n *\n * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому\n * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.\n */\nexport function createMultiTokenStorage(\n  store: EnumerableKeyValueStore<ItdSession>,\n  options: MultiTokenStorageAdapterOptions = {},\n): MultiTokenStorage {\n  const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;\n  if (typeof prefix !== 'string') {\n    throw new ItdConfigError('prefix MultiTokenStorage должен быть строкой');\n  }\n  const backend = createKeyValueStore(store);\n  if (!isEnumerableKeyValueStore(backend)) {\n    throw new ItdConfigError('MultiTokenStorage требует KeyValueStore с методом keys()');\n  }\n  const key = (account: string) => `${prefix}${encodeURIComponent(account)}`;\n  return {\n    async get(account) {\n      const session = await backend.get(key(account));\n      return session ? copySession(session) : null;\n    },\n    set: (account, session) => backend.set(key(account), copySession(session)),\n    clear: (account) => backend.delete(key(account)),\n    async accounts() {\n      const keys = await collectKeyValueStoreKeys(backend, prefix);\n      return keys.flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/multi-storage-CjAPB5Kq.d.cts

@@ -0,0 +1,72 @@
+import { o as EnumerableKeyValueStore, r as TokenStorage, t as ItdSession } from "./storage-C_eICCep.cjs";
+//#region src/session/multi-storage.d.ts
+/**
+ * Хранилище сессий нескольких аккаунтов.
+ *
+ * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:
+ * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,
+ * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:
+ * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения
+ * на длину ключа остаются за адаптером.
+ *
+ * Все методы могут быть как синхронными, так и асинхронными.
+ *
+ * @example Хранилище поверх enumerable Redis backend
+ * ```ts
+ * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));
+ * ```
+ */
+interface MultiTokenStorage {
+  /** Прочитать сессию аккаунта. `null`, если её нет. */
+  get(account: string): ItdSession | null | Promise<ItdSession | null>;
+  /** Сохранить сессию аккаунта целиком. */
+  set(account: string, session: ItdSession): void | Promise<void>;
+  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */
+  clear(account: string): void | Promise<void>;
+  /**
+   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов
+   * после перезапуска процесса.
+   *
+   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,
+   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.
+   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после
+   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.
+   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть
+   * доступны по имени.
+   */
+  accounts(): readonly string[] | Promise<readonly string[]>;
+}
+/**
+ * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
+ * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.
+ */
+declare function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage;
+/**
+ * Мультихранилище в памяти процесса — вариант по умолчанию.
+ *
+ * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`
+ * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
+ */
+declare class MemoryMultiTokenStorage implements MultiTokenStorage {
+  #private;
+  constructor(initial?: Readonly<Record<string, ItdSession>> | null);
+  get(account: string): ItdSession | null;
+  set(account: string, session: ItdSession): void;
+  clear(account: string): void;
+  accounts(): string[];
+}
+/** Настройки доменного адаптера нескольких сессий. */
+interface MultiTokenStorageAdapterOptions {
+  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */
+  prefix?: string | undefined;
+}
+/**
+ * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.
+ *
+ * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому
+ * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.
+ */
+declare function createMultiTokenStorage(store: EnumerableKeyValueStore<ItdSession>, options?: MultiTokenStorageAdapterOptions): MultiTokenStorage;
+//#endregion
+export { scopedTokenStorage as a, createMultiTokenStorage as i, MultiTokenStorage as n, MultiTokenStorageAdapterOptions as r, MemoryMultiTokenStorage as t };
+//# sourceMappingURL=multi-storage-CjAPB5Kq.d.cts.map

package/dist/shared/multi-storage-CkvTUC5m.js

@@ -0,0 +1,121 @@
+import { a as ItdConfigError } from "./errors-Bhrd2fJd.js";
+import { n as CookieJar, t as AUTH_FLAG_COOKIE } from "./cookies-tX2sNwxb.js";
+import { a as collectKeyValueStoreKeys, c as isEnumerableKeyValueStore, i as MemoryKeyValueStore, n as copySession, o as createKeyValueStore } from "./storage-D86edNCB.js";
+//#region src/session/multi-storage.ts
+/**
+* Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
+* отдельный `ItdClient`, который про соседние аккаунты ничего не знает.
+*/
+function scopedTokenStorage(storage, account) {
+	return {
+		get: () => storage.get(account),
+		set: (session) => storage.set(account, session),
+		clear: () => storage.clear(account)
+	};
+}
+/**
+* Можно ли восстановить авторизованный аккаунт из записи.
+*
+* Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет
+* выполнить ни одного авторизованного запроса.
+*
+* @internal
+*/
+function isRestorableSession(session) {
+	if (!session) return false;
+	if (session.accessToken || session.refreshToken) return true;
+	const jar = new CookieJar();
+	jar.deserialize(session.cookies);
+	return jar.has(AUTH_FLAG_COOKIE);
+}
+/** @internal */
+function controlledTokenStorage(storage, account) {
+	let revoked = false;
+	const pending = /* @__PURE__ */ new Set();
+	const mutate = (operation) => {
+		if (revoked) return Promise.resolve();
+		const promise = Promise.resolve().then(operation);
+		pending.add(promise);
+		promise.then(() => pending.delete(promise), () => pending.delete(promise));
+		return promise;
+	};
+	return {
+		storage: {
+			get: () => revoked ? null : storage.get(account),
+			set: (session) => mutate(() => storage.set(account, session)),
+			clear: () => mutate(() => storage.clear(account))
+		},
+		revoke() {
+			revoked = true;
+		},
+		async drain() {
+			await Promise.all([...pending]);
+		}
+	};
+}
+/**
+* Мультихранилище в памяти процесса — вариант по умолчанию.
+*
+* Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`
+* из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
+*/
+var MemoryMultiTokenStorage = class {
+	#store = new MemoryKeyValueStore();
+	constructor(initial) {
+		for (const [account, session] of Object.entries(initial ?? {})) this.#store.set(accountKey(account), copySession(session));
+	}
+	get(account) {
+		const session = this.#store.get(accountKey(account));
+		return session ? copySession(session) : null;
+	}
+	set(account, session) {
+		this.#store.set(accountKey(account), copySession(session));
+	}
+	clear(account) {
+		this.#store.delete(accountKey(account));
+	}
+	accounts() {
+		return this.#store.keys(ACCOUNT_KEY_PREFIX).flatMap((key) => readAccountName(key.slice(ACCOUNT_KEY_PREFIX.length)) ?? []);
+	}
+};
+const ACCOUNT_KEY_PREFIX = "accounts/";
+function accountKey(account) {
+	return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;
+}
+/** Читает имя аккаунта из ключа. `undefined` — ключ не декодируется и запись пропускается. */
+function readAccountName(encoded) {
+	try {
+		return decodeURIComponent(encoded);
+	} catch {
+		console.warn(`[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`);
+		return;
+	}
+}
+/**
+* Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.
+*
+* Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому
+* запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.
+*/
+function createMultiTokenStorage(store, options = {}) {
+	const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;
+	if (typeof prefix !== "string") throw new ItdConfigError("prefix MultiTokenStorage должен быть строкой");
+	const backend = createKeyValueStore(store);
+	if (!isEnumerableKeyValueStore(backend)) throw new ItdConfigError("MultiTokenStorage требует KeyValueStore с методом keys()");
+	const key = (account) => `${prefix}${encodeURIComponent(account)}`;
+	return {
+		async get(account) {
+			const session = await backend.get(key(account));
+			return session ? copySession(session) : null;
+		},
+		set: (account, session) => backend.set(key(account), copySession(session)),
+		clear: (account) => backend.delete(key(account)),
+		async accounts() {
+			return (await collectKeyValueStoreKeys(backend, prefix)).flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);
+		}
+	};
+}
+//#endregion
+export { scopedTokenStorage as a, isRestorableSession as i, controlledTokenStorage as n, createMultiTokenStorage as r, MemoryMultiTokenStorage as t };
+
+//# sourceMappingURL=multi-storage-CkvTUC5m.js.map

package/dist/shared/multi-storage-CkvTUC5m.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-storage-CkvTUC5m.js","names":["#store"],"sources":["../../src/session/multi-storage.ts"],"sourcesContent":["import { AUTH_FLAG_COOKIE, CookieJar } from '../core/cookies.js';\nimport { ItdConfigError } from '../core/errors.js';\nimport {\n  collectKeyValueStoreKeys,\n  createKeyValueStore,\n  type EnumerableKeyValueStore,\n  isEnumerableKeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/key-value-store.js';\nimport { copySession, type ItdSession, type TokenStorage } from './storage.js';\n\n/**\n * Хранилище сессий нескольких аккаунтов.\n *\n * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:\n * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,\n * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:\n * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения\n * на длину ключа остаются за адаптером.\n *\n * Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Хранилище поверх enumerable Redis backend\n * ```ts\n * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport interface MultiTokenStorage {\n  /** Прочитать сессию аккаунта. `null`, если её нет. */\n  get(account: string): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию аккаунта целиком. */\n  set(account: string, session: ItdSession): void | Promise<void>;\n  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(account: string): void | Promise<void>;\n  /**\n   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов\n   * после перезапуска процесса.\n   *\n   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,\n   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.\n   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после\n   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.\n   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть\n   * доступны по имени.\n   */\n  accounts(): readonly string[] | Promise<readonly string[]>;\n}\n\n/**\n * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает\n * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.\n */\nexport function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage {\n  return {\n    get: () => storage.get(account),\n    set: (session) => storage.set(account, session),\n    clear: () => storage.clear(account),\n  };\n}\n\n/**\n * Можно ли восстановить авторизованный аккаунт из записи.\n *\n * Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет\n * выполнить ни одного авторизованного запроса.\n *\n * @internal\n */\nexport function isRestorableSession(session: ItdSession | null): session is ItdSession {\n  if (!session) return false;\n  if (session.accessToken || session.refreshToken) return true;\n\n  const jar = new CookieJar();\n  jar.deserialize(session.cookies);\n  return jar.has(AUTH_FLAG_COOKIE);\n}\n\n/**\n * Управляемый срез хранилища для клиента аккаунта.\n *\n * После `revoke()` новые записи не доходят до общего хранилища, а `drain()` позволяет\n * дождаться уже начатых. Так удалённый клиент или завершившийся с опозданием refresh\n * не воскресят сессию после `removeAccount(..., { forget: true })`.\n *\n * @internal\n */\nexport interface ControlledTokenStorage {\n  storage: TokenStorage;\n  revoke(): void;\n  drain(): Promise<void>;\n}\n\n/** @internal */\nexport function controlledTokenStorage(\n  storage: MultiTokenStorage,\n  account: string,\n): ControlledTokenStorage {\n  let revoked = false;\n  const pending = new Set<Promise<void>>();\n\n  const mutate = (operation: () => void | Promise<void>): Promise<void> => {\n    if (revoked) return Promise.resolve();\n\n    const promise = Promise.resolve().then(operation);\n    pending.add(promise);\n    void promise.then(\n      () => pending.delete(promise),\n      () => pending.delete(promise),\n    );\n    return promise;\n  };\n\n  return {\n    storage: {\n      get: () => (revoked ? null : storage.get(account)),\n      set: (session) => mutate(() => storage.set(account, session)),\n      clear: () => mutate(() => storage.clear(account)),\n    },\n    revoke() {\n      revoked = true;\n    },\n    async drain() {\n      await Promise.all([...pending]);\n    },\n  };\n}\n\n/**\n * Мультихранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`\n * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.\n */\nexport class MemoryMultiTokenStorage implements MultiTokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: Readonly<Record<string, ItdSession>> | null) {\n    for (const [account, session] of Object.entries(initial ?? {})) {\n      this.#store.set(accountKey(account), copySession(session));\n    }\n  }\n\n  get(account: string): ItdSession | null {\n    const session = this.#store.get(accountKey(account));\n    return session ? copySession(session) : null;\n  }\n\n  set(account: string, session: ItdSession): void {\n    this.#store.set(accountKey(account), copySession(session));\n  }\n\n  clear(account: string): void {\n    this.#store.delete(accountKey(account));\n  }\n\n  accounts(): string[] {\n    return this.#store\n      .keys(ACCOUNT_KEY_PREFIX)\n      .flatMap((key) => readAccountName(key.slice(ACCOUNT_KEY_PREFIX.length)) ?? []);\n  }\n}\n\nconst ACCOUNT_KEY_PREFIX = 'accounts/';\n\nfunction accountKey(account: string): string {\n  return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;\n}\n\n/** Читает имя аккаунта из ключа. `undefined` — ключ не декодируется и запись пропускается. */\nfunction readAccountName(encoded: string): string | undefined {\n  try {\n    return decodeURIComponent(encoded);\n  } catch {\n    console.warn(\n      `[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`,\n    );\n    return undefined;\n  }\n}\n\n/** Настройки доменного адаптера нескольких сессий. */\nexport interface MultiTokenStorageAdapterOptions {\n  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */\n  prefix?: string | undefined;\n}\n\n/**\n * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.\n *\n * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому\n * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.\n */\nexport function createMultiTokenStorage(\n  store: EnumerableKeyValueStore<ItdSession>,\n  options: MultiTokenStorageAdapterOptions = {},\n): MultiTokenStorage {\n  const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;\n  if (typeof prefix !== 'string') {\n    throw new ItdConfigError('prefix MultiTokenStorage должен быть строкой');\n  }\n  const backend = createKeyValueStore(store);\n  if (!isEnumerableKeyValueStore(backend)) {\n    throw new ItdConfigError('MultiTokenStorage требует KeyValueStore с методом keys()');\n  }\n  const key = (account: string) => `${prefix}${encodeURIComponent(account)}`;\n  return {\n    async get(account) {\n      const session = await backend.get(key(account));\n      return session ? copySession(session) : null;\n    },\n    set: (account, session) => backend.set(key(account), copySession(session)),\n    clear: (account) => backend.delete(key(account)),\n    async accounts() {\n      const keys = await collectKeyValueStoreKeys(backend, prefix);\n      return keys.flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/multi-storage-DccjD7Ww.d.ts

@@ -0,0 +1,72 @@
+import { o as EnumerableKeyValueStore, r as TokenStorage, t as ItdSession } from "./storage-C_eICCep.js";
+//#region src/session/multi-storage.d.ts
+/**
+ * Хранилище сессий нескольких аккаунтов.
+ *
+ * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:
+ * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,
+ * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:
+ * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения
+ * на длину ключа остаются за адаптером.
+ *
+ * Все методы могут быть как синхронными, так и асинхронными.
+ *
+ * @example Хранилище поверх enumerable Redis backend
+ * ```ts
+ * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));
+ * ```
+ */
+interface MultiTokenStorage {
+  /** Прочитать сессию аккаунта. `null`, если её нет. */
+  get(account: string): ItdSession | null | Promise<ItdSession | null>;
+  /** Сохранить сессию аккаунта целиком. */
+  set(account: string, session: ItdSession): void | Promise<void>;
+  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */
+  clear(account: string): void | Promise<void>;
+  /**
+   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов
+   * после перезапуска процесса.
+   *
+   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,
+   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.
+   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после
+   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.
+   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть
+   * доступны по имени.
+   */
+  accounts(): readonly string[] | Promise<readonly string[]>;
+}
+/**
+ * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
+ * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.
+ */
+declare function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage;
+/**
+ * Мультихранилище в памяти процесса — вариант по умолчанию.
+ *
+ * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`
+ * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
+ */
+declare class MemoryMultiTokenStorage implements MultiTokenStorage {
+  #private;
+  constructor(initial?: Readonly<Record<string, ItdSession>> | null);
+  get(account: string): ItdSession | null;
+  set(account: string, session: ItdSession): void;
+  clear(account: string): void;
+  accounts(): string[];
+}
+/** Настройки доменного адаптера нескольких сессий. */
+interface MultiTokenStorageAdapterOptions {
+  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */
+  prefix?: string | undefined;
+}
+/**
+ * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.
+ *
+ * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому
+ * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.
+ */
+declare function createMultiTokenStorage(store: EnumerableKeyValueStore<ItdSession>, options?: MultiTokenStorageAdapterOptions): MultiTokenStorage;
+//#endregion
+export { scopedTokenStorage as a, createMultiTokenStorage as i, MultiTokenStorage as n, MultiTokenStorageAdapterOptions as r, MemoryMultiTokenStorage as t };
+//# sourceMappingURL=multi-storage-DccjD7Ww.d.ts.map

package/dist/shared/options-Dg5N3r1V.cjs

@@ -0,0 +1,189 @@
+const require_errors = require("./errors-DfU8M5eS.cjs");
+//#region src/core/attachments/contracts.ts
+/** Способ передачи содержимого вложения. */
+const FileTransferMode = Object.freeze({
+	/** Сначала получить файл целиком, затем отправить его как `Blob`. */
+	Buffer: "buffer",
+	/** Передавать данные по мере чтения, не собирая файл целиком в памяти. */
+	Stream: "stream"
+});
+/** Предел размера файла, скачиваемого по адресу, — 100 МиБ. */
+const DEFAULT_URL_FILE_MAX_BYTES = 104857600;
+//#endregion
+//#region src/core/attachments/limits.ts
+/** Проверяет числовую границу до обращения к источнику. */
+function optionalBytes(value, name) {
+	if (value === void 0) return void 0;
+	if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) throw new require_errors.ItdConfigError(`${name} должен быть неотрицательным целым числом, получено: ${value}`);
+	return value;
+}
+/** Создаёт типизированную ошибку превышения размера вложения. */
+function fileTooLarge(url, limit, actual) {
+	const source = url ? ` по адресу ${url}` : "";
+	return new require_errors.ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {
+		reason: require_errors.ItdFileErrorReason.TooLarge,
+		...url ? { url } : {},
+		limit,
+		actual
+	});
+}
+//#endregion
+//#region src/core/attachments/bounded-stream.ts
+/** Потоки, на которые уже наложены счётчик размера и backpressure. */
+const BOUNDED_FILE_STREAMS = /* @__PURE__ */ new WeakSet();
+/** Приводит произвольный чанк потока к байтам. */
+function asBytes(value) {
+	return value instanceof Uint8Array ? value : new Uint8Array(value);
+}
+/** Проверяет значение без обращения к методам потенциально чужого объекта. */
+function isReadableByteStream(value) {
+	return typeof ReadableStream !== "undefined" && value instanceof ReadableStream;
+}
+/**
+* Ограничивает размер и очередь потока. Отмена результирующего потока отменяет исходный.
+*
+* @internal
+*/
+function boundedFileStream(source, options = {}) {
+	const maxBytes = optionalBytes(options.maxBytes, "maxBytes");
+	const streamBufferBytes = optionalBytes(options.streamBufferBytes ?? 4194304, "streamBufferBytes") ?? 4194304;
+	if (streamBufferBytes === 0) throw new require_errors.ItdConfigError("streamBufferBytes должен быть больше нуля");
+	const reader = source.getReader();
+	let total = 0;
+	let finished = false;
+	let abortListener;
+	const cleanup = () => {
+		if (abortListener) options.signal?.removeEventListener("abort", abortListener);
+		abortListener = void 0;
+	};
+	const stream = new ReadableStream({
+		start(controller) {
+			if (!options.signal) return;
+			abortListener = () => {
+				finished = true;
+				reader.cancel(options.signal?.reason).catch(() => {});
+				controller.error(options.signal?.reason ?? new DOMException("Aborted", "AbortError"));
+				cleanup();
+			};
+			if (options.signal.aborted) abortListener();
+			else options.signal.addEventListener("abort", abortListener, { once: true });
+		},
+		async pull(controller) {
+			if (finished) return;
+			try {
+				const next = await reader.read();
+				if (finished) return;
+				if (next.done) {
+					finished = true;
+					cleanup();
+					controller.close();
+					return;
+				}
+				const chunk = asBytes(next.value);
+				total += chunk.byteLength;
+				if (maxBytes !== void 0 && total > maxBytes) {
+					finished = true;
+					await reader.cancel().catch(() => {});
+					cleanup();
+					controller.error(fileTooLarge(options.url, maxBytes, total));
+					return;
+				}
+				controller.enqueue(chunk);
+			} catch (error) {
+				finished = true;
+				cleanup();
+				if (error instanceof require_errors.ItdFileError) {
+					controller.error(error);
+					return;
+				}
+				controller.error(new require_errors.ItdFileError("не удалось прочитать поток вложения", {
+					reason: require_errors.ItdFileErrorReason.Read,
+					...options.url ? { url: options.url } : {},
+					retryable: options.retryableRead ?? false,
+					cause: error
+				}));
+			}
+		},
+		async cancel(reason) {
+			finished = true;
+			cleanup();
+			await reader.cancel(reason).catch(() => {});
+		}
+	}, {
+		highWaterMark: streamBufferBytes,
+		size: (chunk) => chunk.byteLength
+	});
+	BOUNDED_FILE_STREAMS.add(stream);
+	return stream;
+}
+/** Наложены ли на поток ограничения библиотеки. @internal */
+function isBoundedFileStream(stream) {
+	return BOUNDED_FILE_STREAMS.has(stream);
+}
+//#endregion
+//#region src/core/attachments/options.ts
+/** Проверяет и дополняет настройки потока. @internal */
+function resolveFileStreamOptions(options, defaultMaxBytes) {
+	const mode = options.mode ?? FileTransferMode.Buffer;
+	if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) throw new require_errors.ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);
+	if (mode === FileTransferMode.Stream && typeof ReadableStream === "undefined") throw new require_errors.ItdConfigError("эта среда не поддерживает ReadableStream; используйте mode: 'buffer'");
+	const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, "maxBytes");
+	const streamBufferBytes = optionalBytes(options.streamBufferBytes ?? 4194304, "streamBufferBytes") ?? 4194304;
+	if (streamBufferBytes === 0) throw new require_errors.ItdConfigError("streamBufferBytes должен быть больше нуля");
+	return {
+		mode,
+		maxBytes,
+		streamBufferBytes
+	};
+}
+//#endregion
+Object.defineProperty(exports, "DEFAULT_URL_FILE_MAX_BYTES", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_URL_FILE_MAX_BYTES;
+	}
+});
+Object.defineProperty(exports, "FileTransferMode", {
+	enumerable: true,
+	get: function() {
+		return FileTransferMode;
+	}
+});
+Object.defineProperty(exports, "boundedFileStream", {
+	enumerable: true,
+	get: function() {
+		return boundedFileStream;
+	}
+});
+Object.defineProperty(exports, "fileTooLarge", {
+	enumerable: true,
+	get: function() {
+		return fileTooLarge;
+	}
+});
+Object.defineProperty(exports, "isBoundedFileStream", {
+	enumerable: true,
+	get: function() {
+		return isBoundedFileStream;
+	}
+});
+Object.defineProperty(exports, "isReadableByteStream", {
+	enumerable: true,
+	get: function() {
+		return isReadableByteStream;
+	}
+});
+Object.defineProperty(exports, "optionalBytes", {
+	enumerable: true,
+	get: function() {
+		return optionalBytes;
+	}
+});
+Object.defineProperty(exports, "resolveFileStreamOptions", {
+	enumerable: true,
+	get: function() {
+		return resolveFileStreamOptions;
+	}
+});
+
+//# sourceMappingURL=options-Dg5N3r1V.cjs.map