itd-api 0.3.0 → 0.5.0

package/dist/node.d.ts

@@ -1,5 +1,5 @@
-import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.js";
-import { _ as StreamFile, g as LazyFile, m as FileTransferMode, n as MultiTokenStorage, p as FileStreamOptions } from "./multi-storage-BhcA2Izn.js";
+import { r as TokenStorage, t as ItdSession } from "./storage-Doe3lpFQ.js";
+import { f as FileStreamOptions, g as StreamFile, h as LazyFile, n as MultiTokenStorage, p as FileTransferMode } from "./multi-storage-CLqmzq07.js";
 //#region src/node.d.ts
 /** Что можно уточнить у файла с диска. */
 interface PathFileOptions extends FileStreamOptions {
@@ -37,6 +37,21 @@ declare function fromPath(path: string, options?: PathFileOptions & {
   mode?: typeof FileTransferMode.Buffer;
 }): LazyFile;
 declare function fromPath(path: string, options: PathFileOptions): LazyFile | StreamFile;
+/**
+ * Key-value backend в одном JSON-файле.
+ *
+ * Изменения сериализуются внутри экземпляра и записываются атомарным переименованием. Несколько
+ * экземпляров или процессов, направленных на один путь, требуют внешней синхронизации.
+ */
+declare class FileKeyValueStore<T> {
+  #private;
+  /** @param path путь к JSON-файлу. Для секретов добавьте его в `.gitignore`. */
+  constructor(path: string);
+  get(key: string): Promise<T | undefined>;
+  set(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  keys(prefix?: string): Promise<Iterable<string> | AsyncIterable<string>>;
+}
 /**
  * Хранит сессию в файле.
  *
@@ -68,8 +83,7 @@ declare class FileTokenStorage implements TokenStorage {
  * и без общего слепка с очередью записей они теряли бы сессии друг друга. Как и
  * {@link FileTokenStorage}, пишет через временный файл с правами `0600`.
  *
- * Формат — конверт `{ version, accounts }`, а не голая карта: так файл нескольких аккаунтов
- * не спутать с однопользовательским, и чужой не будет молча перезаписан.
+ * Использует тот же версионированный {@link FileKeyValueStore}, что и одиночное хранилище.
  *
  * @example
  * ```ts
@@ -89,5 +103,5 @@ declare class FileMultiTokenStorage implements MultiTokenStorage {
   accounts(): Promise<readonly string[]>;
 }
 //#endregion
-export { FileMultiTokenStorage, FileTokenStorage, PathFileOptions, fromPath };
+export { FileKeyValueStore, FileMultiTokenStorage, FileTokenStorage, PathFileOptions, fromPath };
 //# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -1,5 +1,5 @@
-import { _ as resolveFileStreamOptions, i as createRecordMultiStorage, l as FileTransferMode, u as boundedFileStream } from "./multi-storage-CyMe404l.js";
-import { c as ItdConfigError, f as ItdFileError, n as copySession, p as ItdFileErrorReason } from "./storage-D9tfHx7Z.js";
+import { m as FileTransferMode, o as resolveFileStreamOptions, r as createMultiTokenStorage, s as boundedFileStream } from "./multi-storage-B0r0AInH.js";
+import { b as ItdFileErrorReason, h as ItdConfigError, r as createTokenStorage, s as createRecordKeyValueStore, y as ItdFileError } from "./storage-DWrK3Z4M.js";
 //#region src/node.ts
 /**
 * `itd-api/node` — файловая система для Node, Bun и Deno.
@@ -41,11 +41,12 @@ function fromPath(path, options = {}) {
 			actual: info.size
 		});
 		const file = createReadStream(path, {
-			highWaterMark: Math.min(resolved.streamBufferBytes, 1024 * 1024),
+			highWaterMark: Math.min(resolved.streamBufferBytes, 1048576),
 			...signal ? { signal } : {}
 		});
+		const source = Readable.toWeb(file);
 		return {
-			stream: boundedFileStream(Readable.toWeb(file), {
+			stream: boundedFileStream(source, {
 				...resolved.maxBytes !== void 0 ? { maxBytes: resolved.maxBytes } : {},
 				streamBufferBytes: resolved.streamBufferBytes,
 				...signal ? { signal } : {}
@@ -84,25 +85,22 @@ function fromPath(path, options = {}) {
 /**
 * Читает и разбирает JSON-файл.
 *
-* Отсутствующий файл означает `null`. Остальные ошибки файловой системы не скрываются.
-* Одиночное хранилище ради обратной совместимости считает повреждённый JSON пустым,
-* а мультихранилище требует строгого разбора: молча затереть файл с несколькими токенами
-* особенно опасно.
+* Отсутствующий файл означает `undefined`. Повреждённый JSON не считается пустым хранилищем:
+* иначе следующая запись могла бы незаметно затереть данные.
 */
-async function readJsonFile(path, strict = false) {
+async function readJsonFile(path) {
 	let raw;
 	try {
 		const { readFile } = await import("node:fs/promises");
 		raw = await readFile(path, "utf8");
 	} catch (error) {
-		if (hasErrorCode(error, "ENOENT")) return null;
+		if (hasErrorCode(error, "ENOENT")) return void 0;
 		throw error;
 	}
 	try {
 		return JSON.parse(raw);
 	} catch {
-		if (!strict) return null;
-		throw new ItdConfigError(`Файл ${path} повреждён: ожидался JSON с сессиями аккаунтов. Исправьте файл или перенесите его перед следующим сохранением.`);
+		throw new ItdConfigError(`Файл ${path} повреждён: ожидался JSON key-value хранилища. Исправьте файл или перенесите его перед следующим сохранением.`);
 	}
 }
 /**
@@ -130,6 +128,49 @@ async function removeFile(path) {
 	const { rm } = await import("node:fs/promises");
 	await rm(path, { force: true });
 }
+/** Версия общего формата файлового key-value backend. */
+const FILE_STORE_VERSION = 1;
+/**
+* Key-value backend в одном JSON-файле.
+*
+* Изменения сериализуются внутри экземпляра и записываются атомарным переименованием. Несколько
+* экземпляров или процессов, направленных на один путь, требуют внешней синхронизации.
+*/
+var FileKeyValueStore = class {
+	#path;
+	#inner;
+	/** @param path путь к JSON-файлу. Для секретов добавьте его в `.gitignore`. */
+	constructor(path) {
+		this.#path = path;
+		this.#inner = createRecordKeyValueStore({
+			read: () => this.#read(),
+			write: (values) => writeJsonAtomic(path, {
+				version: FILE_STORE_VERSION,
+				values
+			}),
+			delete: () => removeFile(path)
+		});
+	}
+	get(key) {
+		return Promise.resolve(this.#inner.get(key));
+	}
+	set(key, value) {
+		return Promise.resolve(this.#inner.set(key, value));
+	}
+	delete(key) {
+		return Promise.resolve(this.#inner.delete(key));
+	}
+	keys(prefix) {
+		return Promise.resolve(this.#inner.keys(prefix));
+	}
+	async #read() {
+		const parsed = await readJsonFile(this.#path);
+		if (parsed === void 0) return void 0;
+		const envelope = typeof parsed === "object" && parsed !== null ? parsed : void 0;
+		if (envelope?.version !== FILE_STORE_VERSION || typeof envelope.values !== "object" || envelope.values === null || Array.isArray(envelope.values)) throw new ItdConfigError(`Файл ${this.#path} имеет неподдерживаемый формат: ожидается { version: ${FILE_STORE_VERSION}, values }. Возьмите другой путь, чтобы не перезаписать посторонние данные.`);
+		return envelope.values;
+	}
+};
 /**
 * Хранит сессию в файле.
 *
@@ -147,36 +188,21 @@ async function removeFile(path) {
 * ```
 */
 var FileTokenStorage = class {
-	#path;
-	/**
-	* Цепочка операций с файлом. Запись и удаление выполняются последовательно
-	* в порядке вызова; ошибка одной операции не останавливает следующие.
-	*/
-	#writing = Promise.resolve();
+	#inner;
 	/** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
 	constructor(path) {
-		this.#path = path;
+		this.#inner = createTokenStorage(new FileKeyValueStore(path));
 	}
-	async get() {
-		await this.#writing.then(() => void 0, () => void 0);
-		const parsed = await readJsonFile(this.#path);
-		return typeof parsed === "object" && parsed !== null ? copySession(parsed) : null;
+	get() {
+		return Promise.resolve(this.#inner.get());
 	}
 	set(session) {
-		const snapshot = copySession(session);
-		return this.#enqueue(() => writeJsonAtomic(this.#path, snapshot));
+		return Promise.resolve(this.#inner.set(session));
 	}
 	clear() {
-		return this.#enqueue(() => removeFile(this.#path));
-	}
-	/** Добавляет файловую операцию в очередь. */
-	#enqueue(operation) {
-		this.#writing = this.#writing.then(operation, operation);
-		return this.#writing;
+		return Promise.resolve(this.#inner.clear());
 	}
 };
-/** Версия формата файла с сессиями нескольких аккаунтов. */
-const SESSIONS_FILE_VERSION = 1;
 /**
 * Хранит сессии нескольких аккаунтов в одном файле.
 *
@@ -184,8 +210,7 @@ const SESSIONS_FILE_VERSION = 1;
 * и без общего слепка с очередью записей они теряли бы сессии друг друга. Как и
 * {@link FileTokenStorage}, пишет через временный файл с правами `0600`.
 *
-* Формат — конверт `{ version, accounts }`, а не голая карта: так файл нескольких аккаунтов
-* не спутать с однопользовательским, и чужой не будет молча перезаписан.
+* Использует тот же версионированный {@link FileKeyValueStore}, что и одиночное хранилище.
 *
 * @example
 * ```ts
@@ -196,19 +221,10 @@ const SESSIONS_FILE_VERSION = 1;
 * ```
 */
 var FileMultiTokenStorage = class {
-	#path;
 	#inner;
 	/** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
 	constructor(path) {
-		this.#path = path;
-		this.#inner = createRecordMultiStorage({
-			read: () => this.#read(),
-			write: (accounts) => writeJsonAtomic(path, {
-				version: SESSIONS_FILE_VERSION,
-				accounts
-			}),
-			remove: () => removeFile(path)
-		});
+		this.#inner = createMultiTokenStorage(new FileKeyValueStore(path));
 	}
 	get(account) {
 		return Promise.resolve(this.#inner.get(account));
@@ -222,16 +238,8 @@ var FileMultiTokenStorage = class {
 	accounts() {
 		return Promise.resolve(this.#inner.accounts());
 	}
-	async #read() {
-		const parsed = await readJsonFile(this.#path, true);
-		if (parsed === null) return null;
-		const envelope = typeof parsed === "object" && parsed !== null ? parsed : void 0;
-		const accounts = envelope?.accounts;
-		if (envelope?.version !== SESSIONS_FILE_VERSION || typeof accounts !== "object" || accounts === null || Array.isArray(accounts)) throw new ItdConfigError(`Файл ${this.#path} имеет неподдерживаемый формат: ожидается { version: ${SESSIONS_FILE_VERSION}, accounts }. Возможно, это файл одиночной сессии или файл другой версии — возьмите отдельный путь, чтобы не перезаписать его.`);
-		return accounts;
-	}
 };
 //#endregion
-export { FileMultiTokenStorage, FileTokenStorage, fromPath };
+export { FileKeyValueStore, FileMultiTokenStorage, FileTokenStorage, fromPath };
 
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","names":["#path","#writing","#enqueue","#inner","#read"],"sources":["../src/node.ts"],"sourcesContent":["/**\n * `itd-api/node` — файловая система для Node, Bun и Deno.\n *\n * Здесь лежит только то, что требует `node:fs` и потому не может попасть в основной бандл:\n * иначе браузерные сборщики пытались бы разрешить этот модуль. Клиент, аккаунты, билдеры,\n * типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { FileTokenStorage, fromPath } from 'itd-api/node';\n *\n * // Когда сессия уже сохранена, `auth` не нужен — токен возьмётся из хранилища.\n * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });\n *\n * await itd.posts.create((p) => p.content('привет').attach(fromPath('./photo.jpg')));\n * ```\n *\n * @packageDocumentation\n */\n\nimport {\n  boundedFileStream,\n  type FileStreamOptions,\n  FileTransferMode,\n  type LazyFile,\n  resolveFileStreamOptions,\n  type StreamFile,\n} from './core/attachments.js';\nimport { ItdConfigError, ItdFileError, ItdFileErrorReason } from './core/errors.js';\nimport { createRecordMultiStorage, type MultiTokenStorage } from './core/multi-storage.js';\nimport { copySession, type ItdSession, type TokenStorage } from './core/storage.js';\n\n/** Проверяет код системной ошибки без привязки к типам конкретного рантайма. */\nfunction hasErrorCode(error: unknown, code: string): boolean {\n  return typeof error === 'object' && error !== null && 'code' in error && error.code === code;\n}\n\n/** Что можно уточнить у файла с диска. */\nexport interface PathFileOptions extends FileStreamOptions {\n  /** Имя файла. По умолчанию — имя из пути. */\n  filename?: string | undefined;\n  /** MIME-тип. По умолчанию определяется по расширению. */\n  contentType?: string | undefined;\n}\n\n/**\n * Вложение из файла на диске.\n *\n * Клиент настраивать не нужно: чтение диска приезжает вместе со значением, а не через\n * опцию, поэтому один и тот же клиент принимает и файлы с диска, и всё остальное.\n *\n * По умолчанию файл читается целиком непосредственно перед отправкой. Режим\n * `{ mode: 'stream' }` передаёт его частями и открывает заново при повторной попытке.\n * Модуль `node:fs` подключается динамически.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { fromPath } from 'itd-api/node';\n *\n * const itd = new ItdClient({ auth });\n *\n * await itd.posts.create((p) =>\n *   p.content('смотрите').attach(fromPath('./photo.jpg')),\n * );\n * ```\n */\nexport function fromPath(\n  path: string,\n  options: PathFileOptions & { mode: typeof FileTransferMode.Stream },\n): StreamFile;\nexport function fromPath(\n  path: string,\n  options?: PathFileOptions & { mode?: typeof FileTransferMode.Buffer },\n): LazyFile;\nexport function fromPath(path: string, options: PathFileOptions): LazyFile | StreamFile;\nexport function fromPath(path: string, options: PathFileOptions = {}): LazyFile | StreamFile {\n  const resolved = resolveFileStreamOptions(options);\n\n  if (resolved.mode === FileTransferMode.Stream) {\n    return {\n      open: async ({ signal }) => {\n        const [{ createReadStream }, { stat }, { basename }, { Readable }] = await Promise.all([\n          import('node:fs'),\n          import('node:fs/promises'),\n          import('node:path'),\n          import('node:stream'),\n        ]);\n        const info = await stat(path);\n        if (resolved.maxBytes !== undefined && info.size > resolved.maxBytes) {\n          throw new ItdFileError(\n            `файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`,\n            {\n              reason: ItdFileErrorReason.TooLarge,\n              limit: resolved.maxBytes,\n              actual: info.size,\n            },\n          );\n        }\n\n        const file = createReadStream(path, {\n          highWaterMark: Math.min(resolved.streamBufferBytes, 1024 * 1024),\n          ...(signal ? { signal } : {}),\n        });\n        const source = Readable.toWeb(file) as ReadableStream<Uint8Array>;\n        return {\n          stream: boundedFileStream(source, {\n            ...(resolved.maxBytes !== undefined ? { maxBytes: resolved.maxBytes } : {}),\n            streamBufferBytes: resolved.streamBufferBytes,\n            ...(signal ? { signal } : {}),\n          }),\n          filename: options.filename ?? basename(path),\n          ...(options.contentType ? { contentType: options.contentType } : {}),\n          size: info.size,\n          close: () => {\n            file.destroy();\n          },\n        };\n      },\n    };\n  }\n\n  return {\n    load: async ({ signal }) => {\n      const [{ readFile, stat }, { basename }] = await Promise.all([\n        import('node:fs/promises'),\n        import('node:path'),\n      ]);\n      if (resolved.maxBytes !== undefined) {\n        const info = await stat(path);\n        if (info.size > resolved.maxBytes) {\n          throw new ItdFileError(\n            `файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`,\n            {\n              reason: ItdFileErrorReason.TooLarge,\n              limit: resolved.maxBytes,\n              actual: info.size,\n            },\n          );\n        }\n      }\n\n      const file = new Uint8Array(await readFile(path, signal ? { signal } : undefined));\n      if (resolved.maxBytes !== undefined && file.byteLength > resolved.maxBytes) {\n        throw new ItdFileError(\n          `файл ${path} больше предела в ${resolved.maxBytes} байт: ${file.byteLength}`,\n          {\n            reason: ItdFileErrorReason.TooLarge,\n            limit: resolved.maxBytes,\n            actual: file.byteLength,\n          },\n        );\n      }\n\n      return {\n        file,\n        filename: options.filename ?? basename(path),\n        ...(options.contentType ? { contentType: options.contentType } : {}),\n      };\n    },\n  };\n}\n\n/**\n * Читает и разбирает JSON-файл.\n *\n * Отсутствующий файл означает `null`. Остальные ошибки файловой системы не скрываются.\n * Одиночное хранилище ради обратной совместимости считает повреждённый JSON пустым,\n * а мультихранилище требует строгого разбора: молча затереть файл с несколькими токенами\n * особенно опасно.\n */\nasync function readJsonFile(path: string, strict = false): Promise<unknown> {\n  let raw: string;\n  try {\n    const { readFile } = await import('node:fs/promises');\n    raw = await readFile(path, 'utf8');\n  } catch (error) {\n    if (hasErrorCode(error, 'ENOENT')) return null;\n    throw error;\n  }\n\n  try {\n    return JSON.parse(raw) as unknown;\n  } catch {\n    if (!strict) return null;\n    throw new ItdConfigError(\n      `Файл ${path} повреждён: ожидался JSON с сессиями аккаунтов. ` +\n        'Исправьте файл или перенесите его перед следующим сохранением.',\n    );\n  }\n}\n\n/**\n * Записывает JSON во временный файл и переименовывает его поверх целевого.\n *\n * Права `0600` (чтение и запись только владельцу) — в файле лежат токены. Переименование\n * атомарно, поэтому падение процесса посреди сохранения не оставит повреждённого файла.\n */\nasync function writeJsonAtomic(path: string, value: unknown): Promise<void> {\n  const { writeFile, rename, unlink } = await import('node:fs/promises');\n\n  // Временный файл уникален на процесс и вызов — иначе параллельные записи (в том числе\n  // из разных процессов) делят один `.tmp`.\n  const pid = typeof process !== 'undefined' ? process.pid : 0;\n  const temporary = `${path}.${pid}.${Math.random().toString(36).slice(2)}.tmp`;\n\n  try {\n    await writeFile(temporary, JSON.stringify(value, null, 2), { encoding: 'utf8', mode: 0o600 });\n    await rename(temporary, path);\n  } catch (error) {\n    await unlink(temporary).catch(() => {});\n    throw error;\n  }\n}\n\n/** Удаляет файл. Благодаря `force` отсутствие файла ошибкой не считается. */\nasync function removeFile(path: string): Promise<void> {\n  const { rm } = await import('node:fs/promises');\n  await rm(path, { force: true });\n}\n\n/**\n * Хранит сессию в файле.\n *\n * Нужна долгоживущим процессам: без неё бот при каждом запуске входит заново — а вход\n * требует решённой капчи, да и серия входов подряд может привести к временной блокировке\n * аккаунта. С сохранённой сессией опция `auth` не нужна вовсе.\n *\n * Файл создаётся с правами `0600` (чтение и запись только владельцу) — в нём лежат токены.\n * Запись идёт через временный файл с последующим переименованием, поэтому падение процесса\n * посреди сохранения не оставит повреждённую сессию.\n *\n * @example\n * ```ts\n * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });\n * ```\n */\nexport class FileTokenStorage implements TokenStorage {\n  readonly #path: string;\n  /**\n   * Цепочка операций с файлом. Запись и удаление выполняются последовательно\n   * в порядке вызова; ошибка одной операции не останавливает следующие.\n   */\n  #writing: Promise<void> = Promise.resolve();\n\n  /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */\n  constructor(path: string) {\n    this.#path = path;\n  }\n\n  async get(): Promise<ItdSession | null> {\n    // Чтение, начатое сразу после `set()`/`clear()`, должно видеть результат более ранней\n    // операции, даже если вызывающий код не сохранил и не дождался её промиса.\n    await this.#writing.then(\n      () => undefined,\n      () => undefined,\n    );\n    const parsed = await readJsonFile(this.#path);\n    return typeof parsed === 'object' && parsed !== null ? copySession(parsed as ItdSession) : null;\n  }\n\n  set(session: ItdSession): Promise<void> {\n    // Пользователь может изменить переданный объект сразу после вызова `set()`.\n    // В очередь должен попасть снимок на момент вызова, а не живая ссылка.\n    const snapshot = copySession(session);\n    return this.#enqueue(() => writeJsonAtomic(this.#path, snapshot));\n  }\n\n  clear(): Promise<void> {\n    return this.#enqueue(() => removeFile(this.#path));\n  }\n\n  /** Добавляет файловую операцию в очередь. */\n  #enqueue(operation: () => Promise<void>): Promise<void> {\n    this.#writing = this.#writing.then(operation, operation);\n    return this.#writing;\n  }\n}\n\n/** Версия формата файла с сессиями нескольких аккаунтов. */\nconst SESSIONS_FILE_VERSION = 1;\n\n/**\n * Хранит сессии нескольких аккаунтов в одном файле.\n *\n * Разбирается с гонкой «прочитать, изменить, записать»: десять аккаунтов пишут в один файл,\n * и без общего слепка с очередью записей они теряли бы сессии друг друга. Как и\n * {@link FileTokenStorage}, пишет через временный файл с правами `0600`.\n *\n * Формат — конверт `{ version, accounts }`, а не голая карта: так файл нескольких аккаунтов\n * не спутать с однопользовательским, и чужой не будет молча перезаписан.\n *\n * @example\n * ```ts\n * const accounts = new ItdAccounts({\n *   storage: new FileMultiTokenStorage('./.itd-sessions.json'),\n * });\n * await accounts.restore();\n * ```\n */\nexport class FileMultiTokenStorage implements MultiTokenStorage {\n  readonly #path: string;\n  readonly #inner: MultiTokenStorage;\n\n  /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */\n  constructor(path: string) {\n    this.#path = path;\n    this.#inner = createRecordMultiStorage({\n      read: () => this.#read(),\n      write: (accounts) => writeJsonAtomic(path, { version: SESSIONS_FILE_VERSION, accounts }),\n      // Последний аккаунт ушёл — файл с пустой картой выглядел бы мусором.\n      remove: () => removeFile(path),\n    });\n  }\n\n  get(account: string): Promise<ItdSession | null> {\n    return Promise.resolve(this.#inner.get(account));\n  }\n\n  set(account: string, session: ItdSession): Promise<void> {\n    return Promise.resolve(this.#inner.set(account, session));\n  }\n\n  clear(account: string): Promise<void> {\n    return Promise.resolve(this.#inner.clear(account));\n  }\n\n  accounts(): Promise<readonly string[]> {\n    return Promise.resolve(this.#inner.accounts());\n  }\n\n  async #read(): Promise<Record<string, ItdSession> | null> {\n    const parsed = await readJsonFile(this.#path, true);\n    if (parsed === null) return null;\n\n    const envelope =\n      typeof parsed === 'object' && parsed !== null\n        ? (parsed as { version?: unknown; accounts?: unknown })\n        : undefined;\n    const accounts = envelope?.accounts;\n\n    if (\n      envelope?.version !== SESSIONS_FILE_VERSION ||\n      typeof accounts !== 'object' ||\n      accounts === null ||\n      Array.isArray(accounts)\n    ) {\n      throw new ItdConfigError(\n        `Файл ${this.#path} имеет неподдерживаемый формат: ожидается ` +\n          `{ version: ${SESSIONS_FILE_VERSION}, accounts }. ` +\n          'Возможно, это файл одиночной сессии или файл другой версии — ' +\n          'возьмите отдельный путь, чтобы не перезаписать его.',\n      );\n    }\n\n    return accounts as Record<string, ItdSession>;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"node.js","names":["#path","#inner","#read"],"sources":["../src/node.ts"],"sourcesContent":["/**\n * `itd-api/node` — файловая система для Node, Bun и Deno.\n *\n * Здесь лежит только то, что требует `node:fs` и потому не может попасть в основной бандл:\n * иначе браузерные сборщики пытались бы разрешить этот модуль. Клиент, аккаунты, билдеры,\n * типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { FileTokenStorage, fromPath } from 'itd-api/node';\n *\n * // Когда сессия уже сохранена, `auth` не нужен — токен возьмётся из хранилища.\n * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });\n *\n * await itd.posts.create((p) => p.content('привет').attach(fromPath('./photo.jpg')));\n * ```\n *\n * @packageDocumentation\n */\n\nimport { boundedFileStream } from './core/attachments/bounded-stream.js';\nimport {\n  type FileStreamOptions,\n  FileTransferMode,\n  type LazyFile,\n  type StreamFile,\n} from './core/attachments/contracts.js';\nimport { resolveFileStreamOptions } from './core/attachments/options.js';\nimport { ItdConfigError, ItdFileError, ItdFileErrorReason } from './core/errors.js';\nimport { createRecordKeyValueStore, type EnumerableKeyValueStore } from './core/key-value-store.js';\nimport { createMultiTokenStorage, type MultiTokenStorage } from './core/multi-storage.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './core/storage.js';\n\n/** Проверяет код системной ошибки без привязки к типам конкретного рантайма. */\nfunction hasErrorCode(error: unknown, code: string): boolean {\n  return typeof error === 'object' && error !== null && 'code' in error && error.code === code;\n}\n\n/** Что можно уточнить у файла с диска. */\nexport interface PathFileOptions extends FileStreamOptions {\n  /** Имя файла. По умолчанию — имя из пути. */\n  filename?: string | undefined;\n  /** MIME-тип. По умолчанию определяется по расширению. */\n  contentType?: string | undefined;\n}\n\n/**\n * Вложение из файла на диске.\n *\n * Клиент настраивать не нужно: чтение диска приезжает вместе со значением, а не через\n * опцию, поэтому один и тот же клиент принимает и файлы с диска, и всё остальное.\n *\n * По умолчанию файл читается целиком непосредственно перед отправкой. Режим\n * `{ mode: 'stream' }` передаёт его частями и открывает заново при повторной попытке.\n * Модуль `node:fs` подключается динамически.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { fromPath } from 'itd-api/node';\n *\n * const itd = new ItdClient({ auth });\n *\n * await itd.posts.create((p) =>\n *   p.content('смотрите').attach(fromPath('./photo.jpg')),\n * );\n * ```\n */\nexport function fromPath(\n  path: string,\n  options: PathFileOptions & { mode: typeof FileTransferMode.Stream },\n): StreamFile;\nexport function fromPath(\n  path: string,\n  options?: PathFileOptions & { mode?: typeof FileTransferMode.Buffer },\n): LazyFile;\nexport function fromPath(path: string, options: PathFileOptions): LazyFile | StreamFile;\nexport function fromPath(path: string, options: PathFileOptions = {}): LazyFile | StreamFile {\n  const resolved = resolveFileStreamOptions(options);\n\n  if (resolved.mode === FileTransferMode.Stream) {\n    return {\n      open: async ({ signal }) => {\n        const [{ createReadStream }, { stat }, { basename }, { Readable }] = await Promise.all([\n          import('node:fs'),\n          import('node:fs/promises'),\n          import('node:path'),\n          import('node:stream'),\n        ]);\n        const info = await stat(path);\n        if (resolved.maxBytes !== undefined && info.size > resolved.maxBytes) {\n          throw new ItdFileError(\n            `файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`,\n            {\n              reason: ItdFileErrorReason.TooLarge,\n              limit: resolved.maxBytes,\n              actual: info.size,\n            },\n          );\n        }\n\n        const file = createReadStream(path, {\n          highWaterMark: Math.min(resolved.streamBufferBytes, 1024 * 1024),\n          ...(signal ? { signal } : {}),\n        });\n        const source = Readable.toWeb(file) as ReadableStream<Uint8Array>;\n        return {\n          stream: boundedFileStream(source, {\n            ...(resolved.maxBytes !== undefined ? { maxBytes: resolved.maxBytes } : {}),\n            streamBufferBytes: resolved.streamBufferBytes,\n            ...(signal ? { signal } : {}),\n          }),\n          filename: options.filename ?? basename(path),\n          ...(options.contentType ? { contentType: options.contentType } : {}),\n          size: info.size,\n          close: () => {\n            file.destroy();\n          },\n        };\n      },\n    };\n  }\n\n  return {\n    load: async ({ signal }) => {\n      const [{ readFile, stat }, { basename }] = await Promise.all([\n        import('node:fs/promises'),\n        import('node:path'),\n      ]);\n      if (resolved.maxBytes !== undefined) {\n        const info = await stat(path);\n        if (info.size > resolved.maxBytes) {\n          throw new ItdFileError(\n            `файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`,\n            {\n              reason: ItdFileErrorReason.TooLarge,\n              limit: resolved.maxBytes,\n              actual: info.size,\n            },\n          );\n        }\n      }\n\n      const file = new Uint8Array(await readFile(path, signal ? { signal } : undefined));\n      if (resolved.maxBytes !== undefined && file.byteLength > resolved.maxBytes) {\n        throw new ItdFileError(\n          `файл ${path} больше предела в ${resolved.maxBytes} байт: ${file.byteLength}`,\n          {\n            reason: ItdFileErrorReason.TooLarge,\n            limit: resolved.maxBytes,\n            actual: file.byteLength,\n          },\n        );\n      }\n\n      return {\n        file,\n        filename: options.filename ?? basename(path),\n        ...(options.contentType ? { contentType: options.contentType } : {}),\n      };\n    },\n  };\n}\n\n/**\n * Читает и разбирает JSON-файл.\n *\n * Отсутствующий файл означает `undefined`. Повреждённый JSON не считается пустым хранилищем:\n * иначе следующая запись могла бы незаметно затереть данные.\n */\nasync function readJsonFile(path: string): Promise<unknown> {\n  let raw: string;\n  try {\n    const { readFile } = await import('node:fs/promises');\n    raw = await readFile(path, 'utf8');\n  } catch (error) {\n    if (hasErrorCode(error, 'ENOENT')) return undefined;\n    throw error;\n  }\n\n  try {\n    return JSON.parse(raw) as unknown;\n  } catch {\n    throw new ItdConfigError(\n      `Файл ${path} повреждён: ожидался JSON key-value хранилища. ` +\n        'Исправьте файл или перенесите его перед следующим сохранением.',\n    );\n  }\n}\n\n/**\n * Записывает JSON во временный файл и переименовывает его поверх целевого.\n *\n * Права `0600` (чтение и запись только владельцу) — в файле лежат токены. Переименование\n * атомарно, поэтому падение процесса посреди сохранения не оставит повреждённого файла.\n */\nasync function writeJsonAtomic(path: string, value: unknown): Promise<void> {\n  const { writeFile, rename, unlink } = await import('node:fs/promises');\n\n  // Временный файл уникален на процесс и вызов — иначе параллельные записи (в том числе\n  // из разных процессов) делят один `.tmp`.\n  const pid = typeof process !== 'undefined' ? process.pid : 0;\n  const temporary = `${path}.${pid}.${Math.random().toString(36).slice(2)}.tmp`;\n\n  try {\n    await writeFile(temporary, JSON.stringify(value, null, 2), { encoding: 'utf8', mode: 0o600 });\n    await rename(temporary, path);\n  } catch (error) {\n    await unlink(temporary).catch(() => {});\n    throw error;\n  }\n}\n\n/** Удаляет файл. Благодаря `force` отсутствие файла ошибкой не считается. */\nasync function removeFile(path: string): Promise<void> {\n  const { rm } = await import('node:fs/promises');\n  await rm(path, { force: true });\n}\n\n/** Версия общего формата файлового key-value backend. */\nconst FILE_STORE_VERSION = 1;\n\n/**\n * Key-value backend в одном JSON-файле.\n *\n * Изменения сериализуются внутри экземпляра и записываются атомарным переименованием. Несколько\n * экземпляров или процессов, направленных на один путь, требуют внешней синхронизации.\n */\nexport class FileKeyValueStore<T> {\n  readonly #path: string;\n  readonly #inner: EnumerableKeyValueStore<T>;\n\n  /** @param path путь к JSON-файлу. Для секретов добавьте его в `.gitignore`. */\n  constructor(path: string) {\n    this.#path = path;\n    this.#inner = createRecordKeyValueStore<T>({\n      read: () => this.#read(),\n      write: (values) => writeJsonAtomic(path, { version: FILE_STORE_VERSION, values }),\n      delete: () => removeFile(path),\n    });\n  }\n\n  get(key: string): Promise<T | undefined> {\n    return Promise.resolve(this.#inner.get(key));\n  }\n\n  set(key: string, value: T): Promise<void> {\n    return Promise.resolve(this.#inner.set(key, value));\n  }\n\n  delete(key: string): Promise<void> {\n    return Promise.resolve(this.#inner.delete(key));\n  }\n\n  keys(prefix?: string): Promise<Iterable<string> | AsyncIterable<string>> {\n    return Promise.resolve(this.#inner.keys(prefix));\n  }\n\n  async #read(): Promise<Readonly<Record<string, T>> | undefined> {\n    const parsed = await readJsonFile(this.#path);\n    if (parsed === undefined) return undefined;\n    const envelope =\n      typeof parsed === 'object' && parsed !== null\n        ? (parsed as { version?: unknown; values?: unknown })\n        : undefined;\n    if (\n      envelope?.version !== FILE_STORE_VERSION ||\n      typeof envelope.values !== 'object' ||\n      envelope.values === null ||\n      Array.isArray(envelope.values)\n    ) {\n      throw new ItdConfigError(\n        `Файл ${this.#path} имеет неподдерживаемый формат: ожидается ` +\n          `{ version: ${FILE_STORE_VERSION}, values }. Возьмите другой путь, чтобы не ` +\n          'перезаписать посторонние данные.',\n      );\n    }\n    return envelope.values as Readonly<Record<string, T>>;\n  }\n}\n\n/**\n * Хранит сессию в файле.\n *\n * Нужна долгоживущим процессам: без неё бот при каждом запуске входит заново — а вход\n * требует решённой капчи, да и серия входов подряд может привести к временной блокировке\n * аккаунта. С сохранённой сессией опция `auth` не нужна вовсе.\n *\n * Файл создаётся с правами `0600` (чтение и запись только владельцу) — в нём лежат токены.\n * Запись идёт через временный файл с последующим переименованием, поэтому падение процесса\n * посреди сохранения не оставит повреждённую сессию.\n *\n * @example\n * ```ts\n * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });\n * ```\n */\nexport class FileTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */\n  constructor(path: string) {\n    this.#inner = createTokenStorage(new FileKeyValueStore<ItdSession>(path));\n  }\n\n  get(): Promise<ItdSession | null> {\n    return Promise.resolve(this.#inner.get());\n  }\n\n  set(session: ItdSession): Promise<void> {\n    return Promise.resolve(this.#inner.set(session));\n  }\n\n  clear(): Promise<void> {\n    return Promise.resolve(this.#inner.clear());\n  }\n}\n\n/**\n * Хранит сессии нескольких аккаунтов в одном файле.\n *\n * Разбирается с гонкой «прочитать, изменить, записать»: десять аккаунтов пишут в один файл,\n * и без общего слепка с очередью записей они теряли бы сессии друг друга. Как и\n * {@link FileTokenStorage}, пишет через временный файл с правами `0600`.\n *\n * Использует тот же версионированный {@link FileKeyValueStore}, что и одиночное хранилище.\n *\n * @example\n * ```ts\n * const accounts = new ItdAccounts({\n *   storage: new FileMultiTokenStorage('./.itd-sessions.json'),\n * });\n * await accounts.restore();\n * ```\n */\nexport class FileMultiTokenStorage implements MultiTokenStorage {\n  readonly #inner: MultiTokenStorage;\n\n  /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */\n  constructor(path: string) {\n    this.#inner = createMultiTokenStorage(new FileKeyValueStore<ItdSession>(path));\n  }\n\n  get(account: string): Promise<ItdSession | null> {\n    return Promise.resolve(this.#inner.get(account));\n  }\n\n  set(account: string, session: ItdSession): Promise<void> {\n    return Promise.resolve(this.#inner.set(account, session));\n  }\n\n  clear(account: string): Promise<void> {\n    return Promise.resolve(this.#inner.clear(account));\n  }\n\n  accounts(): Promise<readonly string[]> {\n    return Promise.resolve(this.#inner.accounts());\n  }\n}\n"],"mappings":"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"}

package/dist/{storage-D9tfHx7Z.js → storage-DWrK3Z4M.js}

@@ -15,6 +15,8 @@ const ItdErrorKind = Object.freeze({
 	Timeout: "timeout",
 	/** Запрос отменён через `AbortSignal`. */
 	Abort: "abort",
+	/** Операция невозможна в текущем состоянии объекта. */
+	State: "state",
 	/** Не удалось получить или подготовить содержимое вложения. */
 	File: "file",
 	/** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */
@@ -300,14 +302,26 @@ var ItdAbortError = class extends ItdError {
 	}
 };
 /**
+* Операция невозможна в текущем состоянии объекта.
+*
+* Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
+* новые запросы или создавать realtime-потоки.
+*/
+var ItdStateError = class extends ItdError {
+	constructor(message, options) {
+		super(ItdErrorKind.State, message, options);
+		this.name = "ItdStateError";
+	}
+};
+/**
 * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.
 *
 * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос
 * с одним вариантом ответа.
 */
 var ItdConfigError = class extends ItdError {
-	constructor(message) {
-		super(ItdErrorKind.Config, message);
+	constructor(message, options) {
+		super(ItdErrorKind.Config, message, options);
 		this.name = "ItdConfigError";
 	}
 };
@@ -323,6 +337,10 @@ function isItdApiError(value) {
 function isItdFileError(value) {
 	return isItdError(value) && value.kind === ItdErrorKind.File;
 }
+/** Операция невозможна в текущем состоянии объекта. */
+function isItdStateError(value) {
+	return isItdError(value) && value.kind === ItdErrorKind.State;
+}
 /**
 * Проверяет разновидность ошибки API.
 *
@@ -366,6 +384,158 @@ function isItdServerError(value) {
 	return hasApiKind(value, ItdApiErrorKind.Server);
 }
 //#endregion
+//#region src/core/key-value-store.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireStore(value) {
+	const store = value;
+	if (!isRecord(store)) throw new ItdConfigError("KeyValueStore должен быть объектом");
+	for (const method of [
+		"get",
+		"set",
+		"delete"
+	]) if (typeof store[method] !== "function") throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);
+	if (store.keys !== void 0 && typeof store.keys !== "function") throw new ItdConfigError("KeyValueStore.keys должен быть функцией");
+}
+/** Собирает {@link KeyValueStore} из функций конкретного backend. */
+function createKeyValueStore(handlers) {
+	requireStore(handlers);
+	return handlers;
+}
+/** Проверяет доступность перечисления ключей. */
+function isEnumerableKeyValueStore(store) {
+	return typeof store.keys === "function";
+}
+/** @internal */
+async function collectKeyValueStoreKeys(store, prefix) {
+	const source = await store.keys(prefix);
+	const result = [];
+	for await (const key of source) {
+		if (typeof key !== "string") throw new ItdConfigError("KeyValueStore.keys() должен возвращать только строки");
+		if (prefix === void 0 || key.startsWith(prefix)) result.push(key);
+	}
+	return result;
+}
+/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
+var MemoryKeyValueStore = class {
+	#values = /* @__PURE__ */ new Map();
+	constructor(initial) {
+		for (const [key, value] of initial ?? []) this.#values.set(key, value);
+	}
+	get(key) {
+		return this.#values.get(key);
+	}
+	set(key, value) {
+		this.#values.set(key, value);
+	}
+	delete(key) {
+		this.#values.delete(key);
+	}
+	keys(prefix = "") {
+		return [...this.#values.keys()].filter((key) => key.startsWith(prefix));
+	}
+};
+/** Добавляет namespace ко всем ключам, не меняя исходный backend. */
+function withNamespace(store, namespace, separator = ":") {
+	requireStore(store);
+	if (typeof namespace !== "string" || typeof separator !== "string") throw new ItdConfigError("namespace и separator KeyValueStore должны быть строками");
+	const base = namespace.length === 0 ? "" : `${namespace}${separator}`;
+	const key = (value) => `${base}${value}`;
+	const namespaced = {
+		get: (value) => store.get(key(value)),
+		set: (value, data) => store.set(key(value), data),
+		delete: (value) => store.delete(key(value))
+	};
+	if (isEnumerableKeyValueStore(store)) namespaced.keys = async (prefix = "") => {
+		return (await collectKeyValueStoreKeys(store, key(prefix))).map((value) => value.slice(base.length));
+	};
+	return namespaced;
+}
+/** Преобразует значения на границе backend, сохраняя его пространство ключей. */
+function withCodec(store, codec) {
+	requireStore(store);
+	if (!isRecord(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new ItdConfigError("codec должен содержать функции encode и decode");
+	const encoded = {
+		async get(key) {
+			const value = await store.get(key);
+			return value === void 0 ? void 0 : codec.decode(value);
+		},
+		async set(key, value) {
+			await store.set(key, await codec.encode(value));
+		},
+		delete: (key) => store.delete(key)
+	};
+	if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);
+	return encoded;
+}
+/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */
+function emptyRecord() {
+	return Object.create(null);
+}
+function copyRecord(record) {
+	const copy = emptyRecord();
+	for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;
+	return copy;
+}
+/**
+* Создаёт key-value backend поверх одной общей записи.
+*
+* Чтение выполняется один раз, изменения сразу попадают в локальный снимок, а записи
+* выстраиваются последовательно. Несколько экземпляров или процессов требуют внешней
+* синхронизации со стороны source.
+*/
+function createRecordKeyValueStore(source) {
+	if (!isRecord(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
+	if (source.delete !== void 0 && typeof source.delete !== "function") throw new ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
+	let snapshot;
+	let loading;
+	let writing = Promise.resolve();
+	const load = async () => {
+		if (snapshot !== void 0) return snapshot;
+		loading ??= Promise.resolve(source.read()).then((value) => {
+			if (value !== void 0 && !isRecord(value)) throw new ItdConfigError("RecordKeyValueStoreSource.read() должен вернуть объект");
+			snapshot = copyRecord(value);
+			return snapshot;
+		}).finally(() => {
+			loading = void 0;
+		});
+		return loading;
+	};
+	const flush = () => {
+		const current = copyRecord(snapshot);
+		const operation = async () => {
+			if (source.delete && Object.keys(current).length === 0) await source.delete();
+			else await source.write(current);
+		};
+		writing = writing.then(operation, operation);
+		return writing;
+	};
+	return {
+		async get(key) {
+			const current = await load();
+			await writing;
+			return Object.hasOwn(current, key) ? current[key] : void 0;
+		},
+		async set(key, value) {
+			const current = await load();
+			current[key] = value;
+			await flush();
+		},
+		async delete(key) {
+			const current = await load();
+			if (!Object.hasOwn(current, key)) return;
+			delete current[key];
+			await flush();
+		},
+		async keys(prefix = "") {
+			const current = await load();
+			await writing;
+			return Object.keys(current).filter((key) => key.startsWith(prefix));
+		}
+	};
+}
+//#endregion
 //#region src/core/storage.ts
 /**
 * Создаёт независимый снимок сессии.
@@ -386,39 +556,52 @@ function copySession(session) {
 * Хранилище в памяти процесса — вариант по умолчанию.
 *
 * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
-* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` из `itd-api/web`.
+* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
+* `SessionStorageTokenStorage` из `itd-api/web`.
 */
 var MemoryTokenStorage = class {
-	#session = null;
+	#store = new MemoryKeyValueStore();
 	constructor(initial) {
-		this.#session = initial ? copySession(initial) : null;
+		if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
 	}
 	get() {
-		return this.#session ? copySession(this.#session) : null;
+		const session = this.#store.get(TOKEN_STORAGE_KEY);
+		return session ? copySession(session) : null;
 	}
 	set(session) {
-		this.#session = copySession(session);
+		this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
 	}
 	clear() {
-		this.#session = null;
+		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 TokenStorage} из трёх функций — когда заводить класс избыточно.
+* Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
 *
 * @example
 * ```ts
-* const storage = createTokenStorage({
-*   get: () => db.getSession(userId),
-*   set: (session) => db.saveSession(userId, session),
-*   clear: () => db.deleteSession(userId),
-* });
+* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
 * ```
 */
-function createTokenStorage(handlers) {
-	return handlers;
+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 { isItdRateLimitError as A, isItdAuthError as C, isItdForbiddenError as D, isItdFileError as E, isItdValidationError as M, isItdNotFoundError as O, isItdApiError as S, isItdError as T, ItdPhoneVerificationError as _, ItdApiError as a, ItdTimeoutError as b, ItdConfigError as c, ItdErrorKind as d, ItdFileError as f, ItdNotFoundError as g, ItdNetworkError as h, ItdAbortError as i, isItdServerError as j, isItdPhoneVerificationError as k, ItdConflictError as l, ItdForbiddenError as m, copySession as n, ItdApiErrorKind as o, ItdFileErrorReason as p, createTokenStorage as r, ItdAuthError as s, MemoryTokenStorage as t, ItdError as u, ItdRateLimitError as v, isItdConflictError as w, ItdValidationError as x, ItdServerError as y };
+export { isItdApiError as A, isItdStateError as B, ItdNotFoundError as C, ItdStateError as D, ItdServerError as E, isItdForbiddenError as F, isItdNotFoundError as I, isItdPhoneVerificationError as L, isItdConflictError as M, isItdError as N, ItdTimeoutError as O, isItdFileError as P, isItdRateLimitError as R, ItdNetworkError as S, ItdRateLimitError as T, isItdValidationError as V, ItdError as _, collectKeyValueStoreKeys as a, ItdFileErrorReason as b, isEnumerableKeyValueStore as c, ItdAbortError as d, ItdApiError as f, ItdConflictError as g, ItdConfigError as h, MemoryKeyValueStore as i, isItdAuthError as j, ItdValidationError as k, withCodec as l, ItdAuthError as m, copySession as n, createKeyValueStore as o, ItdApiErrorKind as p, createTokenStorage as r, createRecordKeyValueStore as s, MemoryTokenStorage as t, withNamespace as u, ItdErrorKind as v, ItdPhoneVerificationError as w, ItdForbiddenError as x, ItdFileError as y, isItdServerError as z };
 
-//# sourceMappingURL=storage-D9tfHx7Z.js.map
+//# sourceMappingURL=storage-DWrK3Z4M.js.map