itd-api 0.8.0 → 0.9.0

package/dist/shared/{storage-BLmXmzKF.cjs → key-value-store-B5GYVEYZ.cjs}

@@ -160,96 +160,18 @@ function createRecordKeyValueStore(source) {
 	};
 }
 //#endregion
-//#region src/session/storage.ts
-/**
-* Создаёт независимый снимок сессии.
-*
-* Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.
-* Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива
-* cookie меняла бы уже сохранённую сессию без вызова `set()`.
-*
-* @internal
-*/
-function copySession(session) {
-	return {
-		...session,
-		...session.cookies ? { cookies: [...session.cookies] } : {}
-	};
-}
-/**
-* Хранилище в памяти процесса — вариант по умолчанию.
-*
-* Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
-* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
-* `SessionStorageTokenStorage` из `itd-api/web`.
-*/
-var MemoryTokenStorage = class {
-	#store = new MemoryKeyValueStore();
-	constructor(initial) {
-		if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
-	}
-	get() {
-		const session = this.#store.get(TOKEN_STORAGE_KEY);
-		return session ? copySession(session) : null;
-	}
-	set(session) {
-		this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
-	}
-	clear() {
-		this.#store.delete(TOKEN_STORAGE_KEY);
-	}
-};
-const TOKEN_STORAGE_KEY = "session";
-function isPromise(value) {
-	return typeof value === "object" && value !== null && typeof value.then === "function";
-}
-/**
-* Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
-*
-* @example
-* ```ts
-* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
-* ```
-*/
-function createTokenStorage(store, options = {}) {
-	const key = options.key ?? TOKEN_STORAGE_KEY;
-	if (typeof key !== "string") throw new require_errors.ItdConfigError("key TokenStorage должен быть строкой");
-	const backend = createKeyValueStore(store);
-	return {
-		get() {
-			const value = backend.get(key);
-			if (isPromise(value)) return value.then((session) => session ? copySession(session) : null);
-			return value ? copySession(value) : null;
-		},
-		set: (session) => backend.set(key, copySession(session)),
-		clear: () => backend.delete(key)
-	};
-}
-//#endregion
 Object.defineProperty(exports, "MemoryKeyValueStore", {
 	enumerable: true,
 	get: function() {
 		return MemoryKeyValueStore;
 	}
 });
-Object.defineProperty(exports, "MemoryTokenStorage", {
-	enumerable: true,
-	get: function() {
-		return MemoryTokenStorage;
-	}
-});
 Object.defineProperty(exports, "collectKeyValueStoreKeys", {
 	enumerable: true,
 	get: function() {
 		return collectKeyValueStoreKeys;
 	}
 });
-Object.defineProperty(exports, "copySession", {
-	enumerable: true,
-	get: function() {
-		return copySession;
-	}
-});
 Object.defineProperty(exports, "createKeyValueStore", {
 	enumerable: true,
 	get: function() {
@@ -262,12 +184,6 @@ Object.defineProperty(exports, "createRecordKeyValueStore", {
 		return createRecordKeyValueStore;
 	}
 });
-Object.defineProperty(exports, "createTokenStorage", {
-	enumerable: true,
-	get: function() {
-		return createTokenStorage;
-	}
-});
 Object.defineProperty(exports, "isEnumerableKeyValueStore", {
 	enumerable: true,
 	get: function() {
@@ -287,4 +203,4 @@ Object.defineProperty(exports, "withNamespace", {
 	}
 });
 
-//# sourceMappingURL=storage-BLmXmzKF.cjs.map
+//# sourceMappingURL=key-value-store-B5GYVEYZ.cjs.map

package/dist/shared/key-value-store-B5GYVEYZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store-B5GYVEYZ.cjs","names":["ItdConfigError","#values"],"sources":["../../src/core/key-value-store.ts"],"sourcesContent":["import { ItdConfigError } from './errors.js';\n\n/** Синхронный или асинхронный результат операции хранилища. */\nexport type KeyValueStoreResult<T> = T | Promise<T>;\n\n/** Синхронный или асинхронный источник ключей. */\nexport type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;\n\n/**\n * Минимальный backend именованных значений.\n *\n * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение\n * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.\n */\nexport interface KeyValueStore<T> {\n  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */\n  get(key: string): KeyValueStoreResult<T | undefined>;\n  /** Полностью заменяет значение ключа. */\n  set(key: string, value: T): KeyValueStoreResult<void>;\n  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */\n  delete(key: string): KeyValueStoreResult<void>;\n  /** Перечисляет ключи, при возможности ограничивая их префиксом. */\n  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Backend, который гарантированно умеет перечислять ключи. */\nexport interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {\n  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Кодирует значения для хранения в backend другого типа. */\nexport interface KeyValueCodec<T, Stored> {\n  /** Преобразует доменное значение перед записью. */\n  encode(value: T): KeyValueStoreResult<Stored>;\n  /** Восстанавливает доменное значение после чтения. */\n  decode(value: Stored): KeyValueStoreResult<T>;\n}\n\n/** Источник одной записи, содержащей всю карту key-value. */\nexport interface RecordKeyValueStoreSource<T> {\n  /** Читает всю карту. `undefined` означает отсутствие записи. */\n  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;\n  /** Записывает стабильный снимок всей карты. */\n  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;\n  /** Удаляет запись, когда карта становится пустой. */\n  delete?(): KeyValueStoreResult<void>;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction requireStore(value: unknown): asserts value is KeyValueStore<unknown> {\n  const store = value as KeyValueStore<unknown>;\n  if (!isRecord(store)) throw new ItdConfigError('KeyValueStore должен быть объектом');\n  for (const method of ['get', 'set', 'delete'] as const) {\n    if (typeof store[method] !== 'function') {\n      throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);\n    }\n  }\n  if (store.keys !== undefined && typeof store.keys !== 'function') {\n    throw new ItdConfigError('KeyValueStore.keys должен быть функцией');\n  }\n}\n\nexport function createKeyValueStore<T>(\n  handlers: EnumerableKeyValueStore<T>,\n): EnumerableKeyValueStore<T>;\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;\n/** Собирает {@link KeyValueStore} из функций конкретного backend. */\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T> {\n  requireStore(handlers);\n  return handlers;\n}\n\n/** Проверяет доступность перечисления ключей. */\nexport function isEnumerableKeyValueStore<T>(\n  store: KeyValueStore<T>,\n): store is EnumerableKeyValueStore<T> {\n  return typeof store.keys === 'function';\n}\n\n/** @internal */\nexport async function collectKeyValueStoreKeys<T>(\n  store: EnumerableKeyValueStore<T>,\n  prefix?: string,\n): Promise<string[]> {\n  const source = await store.keys(prefix);\n  const result: string[] = [];\n  for await (const key of source) {\n    if (typeof key !== 'string') {\n      throw new ItdConfigError('KeyValueStore.keys() должен возвращать только строки');\n    }\n    if (prefix === undefined || key.startsWith(prefix)) result.push(key);\n  }\n  return result;\n}\n\n/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */\nexport class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {\n  readonly #values = new Map<string, T>();\n\n  constructor(initial?: Iterable<readonly [string, T]>) {\n    for (const [key, value] of initial ?? []) this.#values.set(key, value);\n  }\n\n  get(key: string): T | undefined {\n    return this.#values.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#values.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#values.delete(key);\n  }\n\n  keys(prefix = ''): string[] {\n    return [...this.#values.keys()].filter((key) => key.startsWith(prefix));\n  }\n}\n\nexport function withNamespace<T>(\n  store: EnumerableKeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): EnumerableKeyValueStore<T>;\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): KeyValueStore<T>;\n/** Добавляет namespace ко всем ключам, не меняя исходный backend. */\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator = ':',\n): KeyValueStore<T> {\n  requireStore(store);\n  if (typeof namespace !== 'string' || typeof separator !== 'string') {\n    throw new ItdConfigError('namespace и separator KeyValueStore должны быть строками');\n  }\n  const base = namespace.length === 0 ? '' : `${namespace}${separator}`;\n  const key = (value: string) => `${base}${value}`;\n  const namespaced: KeyValueStore<T> = {\n    get: (value) => store.get(key(value)),\n    set: (value, data) => store.set(key(value), data),\n    delete: (value) => store.delete(key(value)),\n  };\n\n  if (isEnumerableKeyValueStore(store)) {\n    namespaced.keys = async (prefix = '') => {\n      const keys = await collectKeyValueStoreKeys(store, key(prefix));\n      return keys.map((value) => value.slice(base.length));\n    };\n  }\n  return namespaced;\n}\n\nexport function withCodec<T, Stored>(\n  store: EnumerableKeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): EnumerableKeyValueStore<T>;\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T>;\n/** Преобразует значения на границе backend, сохраняя его пространство ключей. */\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T> {\n  requireStore(store);\n  if (\n    !isRecord(codec) ||\n    typeof codec.encode !== 'function' ||\n    typeof codec.decode !== 'function'\n  ) {\n    throw new ItdConfigError('codec должен содержать функции encode и decode');\n  }\n  const encoded: KeyValueStore<T> = {\n    async get(key) {\n      const value = await store.get(key);\n      return value === undefined ? undefined : codec.decode(value);\n    },\n    async set(key, value) {\n      await store.set(key, await codec.encode(value));\n    },\n    delete: (key) => store.delete(key),\n  };\n  if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);\n  return encoded;\n}\n\n/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */\nfunction emptyRecord<T>(): Record<string, T> {\n  return Object.create(null) as Record<string, T>;\n}\n\nfunction copyRecord<T>(record: Readonly<Record<string, T>> | undefined): Record<string, T> {\n  const copy = emptyRecord<T>();\n  for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;\n  return copy;\n}\n\n/**\n * Создаёт key-value backend поверх одной общей записи.\n *\n * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится\n * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов\n * требуют внешней синхронизации со стороны source.\n */\nexport function createRecordKeyValueStore<T>(\n  source: RecordKeyValueStoreSource<T>,\n): EnumerableKeyValueStore<T> {\n  if (\n    !isRecord(source) ||\n    typeof source.read !== 'function' ||\n    typeof source.write !== 'function'\n  ) {\n    throw new ItdConfigError('RecordKeyValueStoreSource должен содержать read и write');\n  }\n  if (source.delete !== undefined && typeof source.delete !== 'function') {\n    throw new ItdConfigError('RecordKeyValueStoreSource.delete должен быть функцией');\n  }\n\n  let committed: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writes: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (committed !== undefined) return committed;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        committed = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return committed;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  /**\n   * Записывает изменение и фиксирует его только после подтверждения source.\n   *\n   * Черновик строится внутри очереди записей, от текущего зафиксированного состояния.\n   *\n   * @param apply вносит изменение в черновик; `false` — менять нечего\n   */\n  const mutate = (apply: (draft: Record<string, T>) => boolean): Promise<void> => {\n    const run = async (): Promise<void> => {\n      const draft = copyRecord(await load());\n      if (!apply(draft)) return;\n\n      if (source.delete && Object.keys(draft).length === 0) await source.delete();\n      else await source.write(draft);\n      committed = draft;\n    };\n    writes = writes.then(run, run);\n    return writes;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    set(key, value) {\n      return mutate((draft) => {\n        draft[key] = value;\n        return true;\n      });\n    },\n    delete(key) {\n      return mutate((draft) => {\n        if (!Object.hasOwn(draft, key)) return false;\n        delete draft[key];\n        return true;\n      });\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/{storage-CCxn0Kkv.js → key-value-store-Bt2PSMxY.js}

@@ -160,72 +160,6 @@ function createRecordKeyValueStore(source) {
 	};
 }
 //#endregion
-//#region src/session/storage.ts
-/**
-* Создаёт независимый снимок сессии.
-*
-* Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.
-* Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива
-* cookie меняла бы уже сохранённую сессию без вызова `set()`.
-*
-* @internal
-*/
-function copySession(session) {
-	return {
-		...session,
-		...session.cookies ? { cookies: [...session.cookies] } : {}
-	};
-}
-/**
-* Хранилище в памяти процесса — вариант по умолчанию.
-*
-* Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
-* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
-* `SessionStorageTokenStorage` из `itd-api/web`.
-*/
-var MemoryTokenStorage = class {
-	#store = new MemoryKeyValueStore();
-	constructor(initial) {
-		if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
-	}
-	get() {
-		const session = this.#store.get(TOKEN_STORAGE_KEY);
-		return session ? copySession(session) : null;
-	}
-	set(session) {
-		this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
-	}
-	clear() {
-		this.#store.delete(TOKEN_STORAGE_KEY);
-	}
-};
-const TOKEN_STORAGE_KEY = "session";
-function isPromise(value) {
-	return typeof value === "object" && value !== null && typeof value.then === "function";
-}
-/**
-* Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
-*
-* @example
-* ```ts
-* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
-* ```
-*/
-function createTokenStorage(store, options = {}) {
-	const key = options.key ?? TOKEN_STORAGE_KEY;
-	if (typeof key !== "string") throw new ItdConfigError("key TokenStorage должен быть строкой");
-	const backend = createKeyValueStore(store);
-	return {
-		get() {
-			const value = backend.get(key);
-			if (isPromise(value)) return value.then((session) => session ? copySession(session) : null);
-			return value ? copySession(value) : null;
-		},
-		set: (session) => backend.set(key, copySession(session)),
-		clear: () => backend.delete(key)
-	};
-}
-//#endregion
-export { collectKeyValueStoreKeys as a, isEnumerableKeyValueStore as c, MemoryKeyValueStore as i, withCodec as l, copySession as n, createKeyValueStore as o, createTokenStorage as r, createRecordKeyValueStore as s, MemoryTokenStorage as t, withNamespace as u };
+export { isEnumerableKeyValueStore as a, createRecordKeyValueStore as i, collectKeyValueStoreKeys as n, withCodec as o, createKeyValueStore as r, withNamespace as s, MemoryKeyValueStore as t };
 
-//# sourceMappingURL=storage-CCxn0Kkv.js.map
+//# sourceMappingURL=key-value-store-Bt2PSMxY.js.map

package/dist/shared/key-value-store-Bt2PSMxY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store-Bt2PSMxY.js","names":["#values"],"sources":["../../src/core/key-value-store.ts"],"sourcesContent":["import { ItdConfigError } from './errors.js';\n\n/** Синхронный или асинхронный результат операции хранилища. */\nexport type KeyValueStoreResult<T> = T | Promise<T>;\n\n/** Синхронный или асинхронный источник ключей. */\nexport type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;\n\n/**\n * Минимальный backend именованных значений.\n *\n * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение\n * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.\n */\nexport interface KeyValueStore<T> {\n  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */\n  get(key: string): KeyValueStoreResult<T | undefined>;\n  /** Полностью заменяет значение ключа. */\n  set(key: string, value: T): KeyValueStoreResult<void>;\n  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */\n  delete(key: string): KeyValueStoreResult<void>;\n  /** Перечисляет ключи, при возможности ограничивая их префиксом. */\n  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Backend, который гарантированно умеет перечислять ключи. */\nexport interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {\n  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Кодирует значения для хранения в backend другого типа. */\nexport interface KeyValueCodec<T, Stored> {\n  /** Преобразует доменное значение перед записью. */\n  encode(value: T): KeyValueStoreResult<Stored>;\n  /** Восстанавливает доменное значение после чтения. */\n  decode(value: Stored): KeyValueStoreResult<T>;\n}\n\n/** Источник одной записи, содержащей всю карту key-value. */\nexport interface RecordKeyValueStoreSource<T> {\n  /** Читает всю карту. `undefined` означает отсутствие записи. */\n  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;\n  /** Записывает стабильный снимок всей карты. */\n  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;\n  /** Удаляет запись, когда карта становится пустой. */\n  delete?(): KeyValueStoreResult<void>;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction requireStore(value: unknown): asserts value is KeyValueStore<unknown> {\n  const store = value as KeyValueStore<unknown>;\n  if (!isRecord(store)) throw new ItdConfigError('KeyValueStore должен быть объектом');\n  for (const method of ['get', 'set', 'delete'] as const) {\n    if (typeof store[method] !== 'function') {\n      throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);\n    }\n  }\n  if (store.keys !== undefined && typeof store.keys !== 'function') {\n    throw new ItdConfigError('KeyValueStore.keys должен быть функцией');\n  }\n}\n\nexport function createKeyValueStore<T>(\n  handlers: EnumerableKeyValueStore<T>,\n): EnumerableKeyValueStore<T>;\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;\n/** Собирает {@link KeyValueStore} из функций конкретного backend. */\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T> {\n  requireStore(handlers);\n  return handlers;\n}\n\n/** Проверяет доступность перечисления ключей. */\nexport function isEnumerableKeyValueStore<T>(\n  store: KeyValueStore<T>,\n): store is EnumerableKeyValueStore<T> {\n  return typeof store.keys === 'function';\n}\n\n/** @internal */\nexport async function collectKeyValueStoreKeys<T>(\n  store: EnumerableKeyValueStore<T>,\n  prefix?: string,\n): Promise<string[]> {\n  const source = await store.keys(prefix);\n  const result: string[] = [];\n  for await (const key of source) {\n    if (typeof key !== 'string') {\n      throw new ItdConfigError('KeyValueStore.keys() должен возвращать только строки');\n    }\n    if (prefix === undefined || key.startsWith(prefix)) result.push(key);\n  }\n  return result;\n}\n\n/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */\nexport class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {\n  readonly #values = new Map<string, T>();\n\n  constructor(initial?: Iterable<readonly [string, T]>) {\n    for (const [key, value] of initial ?? []) this.#values.set(key, value);\n  }\n\n  get(key: string): T | undefined {\n    return this.#values.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#values.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#values.delete(key);\n  }\n\n  keys(prefix = ''): string[] {\n    return [...this.#values.keys()].filter((key) => key.startsWith(prefix));\n  }\n}\n\nexport function withNamespace<T>(\n  store: EnumerableKeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): EnumerableKeyValueStore<T>;\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): KeyValueStore<T>;\n/** Добавляет namespace ко всем ключам, не меняя исходный backend. */\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator = ':',\n): KeyValueStore<T> {\n  requireStore(store);\n  if (typeof namespace !== 'string' || typeof separator !== 'string') {\n    throw new ItdConfigError('namespace и separator KeyValueStore должны быть строками');\n  }\n  const base = namespace.length === 0 ? '' : `${namespace}${separator}`;\n  const key = (value: string) => `${base}${value}`;\n  const namespaced: KeyValueStore<T> = {\n    get: (value) => store.get(key(value)),\n    set: (value, data) => store.set(key(value), data),\n    delete: (value) => store.delete(key(value)),\n  };\n\n  if (isEnumerableKeyValueStore(store)) {\n    namespaced.keys = async (prefix = '') => {\n      const keys = await collectKeyValueStoreKeys(store, key(prefix));\n      return keys.map((value) => value.slice(base.length));\n    };\n  }\n  return namespaced;\n}\n\nexport function withCodec<T, Stored>(\n  store: EnumerableKeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): EnumerableKeyValueStore<T>;\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T>;\n/** Преобразует значения на границе backend, сохраняя его пространство ключей. */\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T> {\n  requireStore(store);\n  if (\n    !isRecord(codec) ||\n    typeof codec.encode !== 'function' ||\n    typeof codec.decode !== 'function'\n  ) {\n    throw new ItdConfigError('codec должен содержать функции encode и decode');\n  }\n  const encoded: KeyValueStore<T> = {\n    async get(key) {\n      const value = await store.get(key);\n      return value === undefined ? undefined : codec.decode(value);\n    },\n    async set(key, value) {\n      await store.set(key, await codec.encode(value));\n    },\n    delete: (key) => store.delete(key),\n  };\n  if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);\n  return encoded;\n}\n\n/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */\nfunction emptyRecord<T>(): Record<string, T> {\n  return Object.create(null) as Record<string, T>;\n}\n\nfunction copyRecord<T>(record: Readonly<Record<string, T>> | undefined): Record<string, T> {\n  const copy = emptyRecord<T>();\n  for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;\n  return copy;\n}\n\n/**\n * Создаёт key-value backend поверх одной общей записи.\n *\n * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится\n * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов\n * требуют внешней синхронизации со стороны source.\n */\nexport function createRecordKeyValueStore<T>(\n  source: RecordKeyValueStoreSource<T>,\n): EnumerableKeyValueStore<T> {\n  if (\n    !isRecord(source) ||\n    typeof source.read !== 'function' ||\n    typeof source.write !== 'function'\n  ) {\n    throw new ItdConfigError('RecordKeyValueStoreSource должен содержать read и write');\n  }\n  if (source.delete !== undefined && typeof source.delete !== 'function') {\n    throw new ItdConfigError('RecordKeyValueStoreSource.delete должен быть функцией');\n  }\n\n  let committed: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writes: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (committed !== undefined) return committed;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        committed = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return committed;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  /**\n   * Записывает изменение и фиксирует его только после подтверждения source.\n   *\n   * Черновик строится внутри очереди записей, от текущего зафиксированного состояния.\n   *\n   * @param apply вносит изменение в черновик; `false` — менять нечего\n   */\n  const mutate = (apply: (draft: Record<string, T>) => boolean): Promise<void> => {\n    const run = async (): Promise<void> => {\n      const draft = copyRecord(await load());\n      if (!apply(draft)) return;\n\n      if (source.delete && Object.keys(draft).length === 0) await source.delete();\n      else await source.write(draft);\n      committed = draft;\n    };\n    writes = writes.then(run, run);\n    return writes;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    set(key, value) {\n      return mutate((draft) => {\n        draft[key] = value;\n        return true;\n      });\n    },\n    delete(key) {\n      return mutate((draft) => {\n        if (!Object.hasOwn(draft, key)) return false;\n        delete draft[key];\n        return true;\n      });\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/key-value-store-COZaNHZS.d.cts

@@ -0,0 +1,69 @@
+//#region src/core/key-value-store.d.ts
+/** Синхронный или асинхронный результат операции хранилища. */
+type KeyValueStoreResult<T> = T | Promise<T>;
+/** Синхронный или асинхронный источник ключей. */
+type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;
+/**
+ * Минимальный backend именованных значений.
+ *
+ * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение
+ * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.
+ */
+interface KeyValueStore<T> {
+  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */
+  get(key: string): KeyValueStoreResult<T | undefined>;
+  /** Полностью заменяет значение ключа. */
+  set(key: string, value: T): KeyValueStoreResult<void>;
+  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */
+  delete(key: string): KeyValueStoreResult<void>;
+  /** Перечисляет ключи, при возможности ограничивая их префиксом. */
+  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
+}
+/** Backend, который гарантированно умеет перечислять ключи. */
+interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {
+  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
+}
+/** Кодирует значения для хранения в backend другого типа. */
+interface KeyValueCodec<T, Stored> {
+  /** Преобразует доменное значение перед записью. */
+  encode(value: T): KeyValueStoreResult<Stored>;
+  /** Восстанавливает доменное значение после чтения. */
+  decode(value: Stored): KeyValueStoreResult<T>;
+}
+/** Источник одной записи, содержащей всю карту key-value. */
+interface RecordKeyValueStoreSource<T> {
+  /** Читает всю карту. `undefined` означает отсутствие записи. */
+  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;
+  /** Записывает стабильный снимок всей карты. */
+  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;
+  /** Удаляет запись, когда карта становится пустой. */
+  delete?(): KeyValueStoreResult<void>;
+}
+declare function createKeyValueStore<T>(handlers: EnumerableKeyValueStore<T>): EnumerableKeyValueStore<T>;
+declare function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;
+/** Проверяет доступность перечисления ключей. */
+declare function isEnumerableKeyValueStore<T>(store: KeyValueStore<T>): store is EnumerableKeyValueStore<T>;
+/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
+declare class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {
+  #private;
+  constructor(initial?: Iterable<readonly [string, T]>);
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  delete(key: string): void;
+  keys(prefix?: string): string[];
+}
+declare function withNamespace<T>(store: EnumerableKeyValueStore<T>, namespace: string, separator?: string): EnumerableKeyValueStore<T>;
+declare function withNamespace<T>(store: KeyValueStore<T>, namespace: string, separator?: string): KeyValueStore<T>;
+declare function withCodec<T, Stored>(store: EnumerableKeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): EnumerableKeyValueStore<T>;
+declare function withCodec<T, Stored>(store: KeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): KeyValueStore<T>;
+/**
+ * Создаёт key-value backend поверх одной общей записи.
+ *
+ * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится
+ * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов
+ * требуют внешней синхронизации со стороны source.
+ */
+declare function createRecordKeyValueStore<T>(source: RecordKeyValueStoreSource<T>): EnumerableKeyValueStore<T>;
+//#endregion
+export { KeyValueStoreResult as a, createKeyValueStore as c, withCodec as d, withNamespace as f, KeyValueStoreKeys as i, createRecordKeyValueStore as l, KeyValueCodec as n, MemoryKeyValueStore as o, KeyValueStore as r, RecordKeyValueStoreSource as s, EnumerableKeyValueStore as t, isEnumerableKeyValueStore as u };
+//# sourceMappingURL=key-value-store-COZaNHZS.d.cts.map

package/dist/shared/key-value-store-COZaNHZS.d.ts

@@ -0,0 +1,69 @@
+//#region src/core/key-value-store.d.ts
+/** Синхронный или асинхронный результат операции хранилища. */
+type KeyValueStoreResult<T> = T | Promise<T>;
+/** Синхронный или асинхронный источник ключей. */
+type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;
+/**
+ * Минимальный backend именованных значений.
+ *
+ * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение
+ * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.
+ */
+interface KeyValueStore<T> {
+  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */
+  get(key: string): KeyValueStoreResult<T | undefined>;
+  /** Полностью заменяет значение ключа. */
+  set(key: string, value: T): KeyValueStoreResult<void>;
+  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */
+  delete(key: string): KeyValueStoreResult<void>;
+  /** Перечисляет ключи, при возможности ограничивая их префиксом. */
+  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
+}
+/** Backend, который гарантированно умеет перечислять ключи. */
+interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {
+  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
+}
+/** Кодирует значения для хранения в backend другого типа. */
+interface KeyValueCodec<T, Stored> {
+  /** Преобразует доменное значение перед записью. */
+  encode(value: T): KeyValueStoreResult<Stored>;
+  /** Восстанавливает доменное значение после чтения. */
+  decode(value: Stored): KeyValueStoreResult<T>;
+}
+/** Источник одной записи, содержащей всю карту key-value. */
+interface RecordKeyValueStoreSource<T> {
+  /** Читает всю карту. `undefined` означает отсутствие записи. */
+  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;
+  /** Записывает стабильный снимок всей карты. */
+  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;
+  /** Удаляет запись, когда карта становится пустой. */
+  delete?(): KeyValueStoreResult<void>;
+}
+declare function createKeyValueStore<T>(handlers: EnumerableKeyValueStore<T>): EnumerableKeyValueStore<T>;
+declare function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;
+/** Проверяет доступность перечисления ключей. */
+declare function isEnumerableKeyValueStore<T>(store: KeyValueStore<T>): store is EnumerableKeyValueStore<T>;
+/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
+declare class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {
+  #private;
+  constructor(initial?: Iterable<readonly [string, T]>);
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  delete(key: string): void;
+  keys(prefix?: string): string[];
+}
+declare function withNamespace<T>(store: EnumerableKeyValueStore<T>, namespace: string, separator?: string): EnumerableKeyValueStore<T>;
+declare function withNamespace<T>(store: KeyValueStore<T>, namespace: string, separator?: string): KeyValueStore<T>;
+declare function withCodec<T, Stored>(store: EnumerableKeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): EnumerableKeyValueStore<T>;
+declare function withCodec<T, Stored>(store: KeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): KeyValueStore<T>;
+/**
+ * Создаёт key-value backend поверх одной общей записи.
+ *
+ * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится
+ * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов
+ * требуют внешней синхронизации со стороны source.
+ */
+declare function createRecordKeyValueStore<T>(source: RecordKeyValueStoreSource<T>): EnumerableKeyValueStore<T>;
+//#endregion
+export { KeyValueStoreResult as a, createKeyValueStore as c, withCodec as d, withNamespace as f, KeyValueStoreKeys as i, createRecordKeyValueStore as l, KeyValueCodec as n, MemoryKeyValueStore as o, KeyValueStore as r, RecordKeyValueStoreSource as s, EnumerableKeyValueStore as t, isEnumerableKeyValueStore as u };
+//# sourceMappingURL=key-value-store-COZaNHZS.d.ts.map

package/dist/shared/{multi-storage-DccjD7Ww.d.ts → multi-storage-BEL7tcKn.d.cts}

@@ -1,4 +1,5 @@
-import { o as EnumerableKeyValueStore, r as TokenStorage, t as ItdSession } from "./storage-C_eICCep.js";
+import { t as EnumerableKeyValueStore } from "./key-value-store-COZaNHZS.cjs";
+import { r as TokenStorage, t as ItdSession } from "./storage-BQrtKon9.cjs";
 //#region src/session/multi-storage.d.ts
 /**
  * Хранилище сессий нескольких аккаунтов.
@@ -69,4 +70,4 @@ interface MultiTokenStorageAdapterOptions {
 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
+//# sourceMappingURL=multi-storage-BEL7tcKn.d.cts.map

package/dist/shared/{multi-storage-CCUgkqvI.cjs → multi-storage-CDKLa956.cjs}

@@ -1,6 +1,7 @@
 const require_errors = require("./errors-BmP3TKoW.cjs");
-const require_redact = require("./redact-DB9EMGJx.cjs");
-const require_storage = require("./storage-BLmXmzKF.cjs");
+const require_redact = require("./redact-BP00URmQ.cjs");
+const require_key_value_store = require("./key-value-store-B5GYVEYZ.cjs");
+const require_storage = require("./storage-QNVxzpDB.cjs");
 //#region src/session/multi-storage.ts
 /**
 * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
@@ -60,7 +61,7 @@ function controlledTokenStorage(storage, account) {
 * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
 */
 var MemoryMultiTokenStorage = class {
-	#store = new require_storage.MemoryKeyValueStore();
+	#store = new require_key_value_store.MemoryKeyValueStore();
 	constructor(initial) {
 		for (const [account, session] of Object.entries(initial ?? {})) this.#store.set(accountKey(account), require_storage.copySession(session));
 	}
@@ -100,8 +101,8 @@ function readAccountName(encoded) {
 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 backend = require_key_value_store.createKeyValueStore(store);
+	if (!require_key_value_store.isEnumerableKeyValueStore(backend)) throw new require_errors.ItdConfigError("MultiTokenStorage требует KeyValueStore с методом keys()");
 	const key = (account) => `${prefix}${encodeURIComponent(account)}`;
 	return {
 		async get(account) {
@@ -111,7 +112,7 @@ function createMultiTokenStorage(store, options = {}) {
 		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)) ?? []);
+			return (await require_key_value_store.collectKeyValueStoreKeys(backend, prefix)).flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);
 		}
 	};
 }
@@ -147,4 +148,4 @@ Object.defineProperty(exports, "scopedTokenStorage", {
 	}
 });
 
-//# sourceMappingURL=multi-storage-CCUgkqvI.cjs.map
+//# sourceMappingURL=multi-storage-CDKLa956.cjs.map

package/dist/shared/{multi-storage-CCUgkqvI.cjs.map → multi-storage-CDKLa956.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"multi-storage-CCUgkqvI.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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"}
+{"version":3,"file":"multi-storage-CDKLa956.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 → multi-storage-LkljOSzA.d.ts}

@@ -1,4 +1,5 @@
-import { o as EnumerableKeyValueStore, r as TokenStorage, t as ItdSession } from "./storage-C_eICCep.cjs";
+import { t as EnumerableKeyValueStore } from "./key-value-store-COZaNHZS.js";
+import { r as TokenStorage, t as ItdSession } from "./storage-CTRGT5wF.js";
 //#region src/session/multi-storage.d.ts
 /**
  * Хранилище сессий нескольких аккаунтов.
@@ -69,4 +70,4 @@ interface MultiTokenStorageAdapterOptions {
 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
+//# sourceMappingURL=multi-storage-LkljOSzA.d.ts.map

package/dist/shared/{multi-storage-1AEZTczk.js → multi-storage-SoW05uzO.js}

@@ -1,6 +1,7 @@
 import { a as ItdConfigError } from "./errors-GI10kZxk.js";
-import { o as AUTH_FLAG_COOKIE, s as CookieJar } from "./redact-FNK29Fv-.js";
-import { a as collectKeyValueStoreKeys, c as isEnumerableKeyValueStore, i as MemoryKeyValueStore, n as copySession, o as createKeyValueStore } from "./storage-CCxn0Kkv.js";
+import { o as AUTH_FLAG_COOKIE, s as CookieJar } from "./redact-Ba5iSVYZ.js";
+import { a as isEnumerableKeyValueStore, n as collectKeyValueStoreKeys, r as createKeyValueStore, t as MemoryKeyValueStore } from "./key-value-store-Bt2PSMxY.js";
+import { n as copySession } from "./storage-CfHKzVHf.js";
 //#region src/session/multi-storage.ts
 /**
 * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
@@ -118,4 +119,4 @@ function createMultiTokenStorage(store, options = {}) {
 //#endregion
 export { scopedTokenStorage as a, isRestorableSession as i, controlledTokenStorage as n, createMultiTokenStorage as r, MemoryMultiTokenStorage as t };
 
-//# sourceMappingURL=multi-storage-1AEZTczk.js.map
+//# sourceMappingURL=multi-storage-SoW05uzO.js.map

package/dist/shared/{multi-storage-1AEZTczk.js.map → multi-storage-SoW05uzO.js.map}

@@ -1 +1 @@
-{"version":3,"file":"multi-storage-1AEZTczk.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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"}
+{"version":3,"file":"multi-storage-SoW05uzO.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":";;;;;;;;;AAoDA,SAAgB,mBAAmB,SAA4B,SAA+B;CAC5F,OAAO;EACL,WAAW,QAAQ,IAAI,OAAO;EAC9B,MAAM,YAAY,QAAQ,IAAI,SAAS,OAAO;EAC9C,aAAa,QAAQ,MAAM,OAAO;CACpC;AACF;;;;;;;;;AAUA,SAAgB,oBAAoB,SAAmD;CACrF,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,eAAe,QAAQ,cAAc,OAAO;CAExD,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,YAAY,QAAQ,OAAO;CAC/B,OAAO,IAAI,IAAI,gBAAgB;AACjC;;AAkBA,SAAgB,uBACd,SACA,SACwB;CACxB,IAAI,UAAU;CACd,MAAM,0BAAU,IAAI,IAAmB;CAEvC,MAAM,UAAU,cAAyD;EACvE,IAAI,SAAS,OAAO,QAAQ,QAAQ;EAEpC,MAAM,UAAU,QAAQ,QAAQ,CAAC,CAAC,KAAK,SAAS;EAChD,QAAQ,IAAI,OAAO;EACnB,QAAa,WACL,QAAQ,OAAO,OAAO,SACtB,QAAQ,OAAO,OAAO,CAC9B;EACA,OAAO;CACT;CAEA,OAAO;EACL,SAAS;GACP,WAAY,UAAU,OAAO,QAAQ,IAAI,OAAO;GAChD,MAAM,YAAY,aAAa,QAAQ,IAAI,SAAS,OAAO,CAAC;GAC5D,aAAa,aAAa,QAAQ,MAAM,OAAO,CAAC;EAClD;EACA,SAAS;GACP,UAAU;EACZ;EACA,MAAM,QAAQ;GACZ,MAAM,QAAQ,IAAI,CAAC,GAAG,OAAO,CAAC;EAChC;CACF;AACF;;;;;;;AAQA,IAAa,0BAAb,MAAkE;CAChE,SAAkB,IAAI,oBAAgC;CAEtD,YAAY,SAAuD;EACjE,KAAK,MAAM,CAAC,SAAS,YAAY,OAAO,QAAQ,WAAW,CAAC,CAAC,GAC3D,KAAKA,OAAO,IAAI,WAAW,OAAO,GAAG,YAAY,OAAO,CAAC;CAE7D;CAEA,IAAI,SAAoC;EACtC,MAAM,UAAU,KAAKA,OAAO,IAAI,WAAW,OAAO,CAAC;EACnD,OAAO,UAAU,YAAY,OAAO,IAAI;CAC1C;CAEA,IAAI,SAAiB,SAA2B;EAC9C,KAAKA,OAAO,IAAI,WAAW,OAAO,GAAG,YAAY,OAAO,CAAC;CAC3D;CAEA,MAAM,SAAuB;EAC3B,KAAKA,OAAO,OAAO,WAAW,OAAO,CAAC;CACxC;CAEA,WAAqB;EACnB,OAAO,KAAKA,OACT,KAAK,kBAAkB,CAAC,CACxB,SAAS,QAAQ,gBAAgB,IAAI,MAAM,mBAAmB,MAAM,CAAC,KAAK,CAAC,CAAC;CACjF;AACF;AAEA,MAAM,qBAAqB;AAE3B,SAAS,WAAW,SAAyB;CAC3C,OAAO,GAAG,qBAAqB,mBAAmB,OAAO;AAC3D;;AAGA,SAAS,gBAAgB,SAAqC;CAC5D,IAAI;EACF,OAAO,mBAAmB,OAAO;CACnC,QAAQ;EACN,QAAQ,KACN,8CAA8C,KAAK,UAAU,OAAO,EAAE,iBACxE;EACA;CACF;AACF;;;;;;;AAcA,SAAgB,wBACd,OACA,UAA2C,CAAC,GACzB;CACnB,MAAM,SAAS,QAAQ,UAAU;CACjC,IAAI,OAAO,WAAW,UACpB,MAAM,IAAI,eAAe,8CAA8C;CAEzE,MAAM,UAAU,oBAAoB,KAAK;CACzC,IAAI,CAAC,0BAA0B,OAAO,GACpC,MAAM,IAAI,eAAe,0DAA0D;CAErF,MAAM,OAAO,YAAoB,GAAG,SAAS,mBAAmB,OAAO;CACvE,OAAO;EACL,MAAM,IAAI,SAAS;GACjB,MAAM,UAAU,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC;GAC9C,OAAO,UAAU,YAAY,OAAO,IAAI;EAC1C;EACA,MAAM,SAAS,YAAY,QAAQ,IAAI,IAAI,OAAO,GAAG,YAAY,OAAO,CAAC;EACzE,QAAQ,YAAY,QAAQ,OAAO,IAAI,OAAO,CAAC;EAC/C,MAAM,WAAW;GAEf,QAAO,MADY,yBAAyB,SAAS,MAAM,EAAA,CAC/C,SAAS,UAAU,gBAAgB,MAAM,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;EAClF;CACF;AACF"}