itd-api 0.4.0 → 0.6.0

package/dist/node.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_multi_storage = require("./multi-storage-C8R5Crwo.cjs");
-const require_storage = require("./storage-ycBqLBRB.cjs");
+const require_multi_storage = require("./multi-storage-Bf84xiO8.cjs");
+const require_storage = require("./storage-DnzZPS_9.cjs");
 //#region src/node.ts
 /**
 * `itd-api/node` — файловая система для Node, Bun и Deno.
@@ -42,11 +42,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: require_multi_storage.boundedFileStream(Readable.toWeb(file), {
+			stream: require_multi_storage.boundedFileStream(source, {
 				...resolved.maxBytes !== void 0 ? { maxBytes: resolved.maxBytes } : {},
 				streamBufferBytes: resolved.streamBufferBytes,
 				...signal ? { signal } : {}
@@ -85,25 +86,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 require_storage.ItdConfigError(`Файл ${path} повреждён: ожидался JSON с сессиями аккаунтов. Исправьте файл или перенесите его перед следующим сохранением.`);
+		throw new require_storage.ItdConfigError(`Файл ${path} повреждён: ожидался JSON key-value хранилища. Исправьте файл или перенесите его перед следующим сохранением.`);
 	}
 }
 /**
@@ -131,6 +129,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 = require_storage.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 require_storage.ItdConfigError(`Файл ${this.#path} имеет неподдерживаемый формат: ожидается { version: ${FILE_STORE_VERSION}, values }. Возьмите другой путь, чтобы не перезаписать посторонние данные.`);
+		return envelope.values;
+	}
+};
 /**
 * Хранит сессию в файле.
 *
@@ -148,36 +189,21 @@ async function removeFile(path) {
 * ```
 */
 var FileTokenStorage = class {
-	#path;
-	/**
-	* Цепочка операций с файлом. Запись и удаление выполняются последовательно
-	* в порядке вызова; ошибка одной операции не останавливает следующие.
-	*/
-	#writing = Promise.resolve();
+	#inner;
 	/** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
 	constructor(path) {
-		this.#path = path;
+		this.#inner = require_storage.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 ? require_storage.copySession(parsed) : null;
+	get() {
+		return Promise.resolve(this.#inner.get());
 	}
 	set(session) {
-		const snapshot = require_storage.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;
 /**
 * Хранит сессии нескольких аккаунтов в одном файле.
 *
@@ -185,8 +211,7 @@ const SESSIONS_FILE_VERSION = 1;
 * и без общего слепка с очередью записей они теряли бы сессии друг друга. Как и
 * {@link FileTokenStorage}, пишет через временный файл с правами `0600`.
 *
-* Формат — конверт `{ version, accounts }`, а не голая карта: так файл нескольких аккаунтов
-* не спутать с однопользовательским, и чужой не будет молча перезаписан.
+* Использует тот же версионированный {@link FileKeyValueStore}, что и одиночное хранилище.
 *
 * @example
 * ```ts
@@ -197,19 +222,10 @@ const SESSIONS_FILE_VERSION = 1;
 * ```
 */
 var FileMultiTokenStorage = class {
-	#path;
 	#inner;
 	/** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
 	constructor(path) {
-		this.#path = path;
-		this.#inner = require_multi_storage.createRecordMultiStorage({
-			read: () => this.#read(),
-			write: (accounts) => writeJsonAtomic(path, {
-				version: SESSIONS_FILE_VERSION,
-				accounts
-			}),
-			remove: () => removeFile(path)
-		});
+		this.#inner = require_multi_storage.createMultiTokenStorage(new FileKeyValueStore(path));
 	}
 	get(account) {
 		return Promise.resolve(this.#inner.get(account));
@@ -223,16 +239,9 @@ 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 require_storage.ItdConfigError(`Файл ${this.#path} имеет неподдерживаемый формат: ожидается { version: ${SESSIONS_FILE_VERSION}, accounts }. Возможно, это файл одиночной сессии или файл другой версии — возьмите отдельный путь, чтобы не перезаписать его.`);
-		return accounts;
-	}
 };
 //#endregion
+exports.FileKeyValueStore = FileKeyValueStore;
 exports.FileMultiTokenStorage = FileMultiTokenStorage;
 exports.FileTokenStorage = FileTokenStorage;
 exports.fromPath = fromPath;

package/dist/node.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.cjs","names":["resolveFileStreamOptions","FileTransferMode","ItdFileError","ItdFileErrorReason","boundedFileStream","ItdConfigError","#path","#writing","copySession","#enqueue","#inner","createRecordMultiStorage","#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 { 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":";;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAS,aAAa,OAAgB,MAAuB;CAC3D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU,SAAS,MAAM,SAAS;AAC1F;AAyCA,SAAgB,SAAS,MAAc,UAA2B,CAAC,GAA0B;CAC3F,MAAM,WAAWA,sBAAAA,yBAAyB,OAAO;CAEjD,IAAI,SAAS,SAASC,sBAAAA,iBAAiB,QACrC,OAAO,EACL,MAAM,OAAO,EAAE,aAAa;EAC1B,MAAM,CAAC,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,MAAM,QAAQ,IAAI;GACrF,OAAO;GACP,OAAO;GACP,OAAO;GACP,OAAO;EACT,CAAC;EACD,MAAM,OAAO,MAAM,KAAK,IAAI;EAC5B,IAAI,SAAS,aAAa,KAAA,KAAa,KAAK,OAAO,SAAS,UAC1D,MAAM,IAAIC,gBAAAA,aACR,QAAQ,KAAK,oBAAoB,SAAS,SAAS,SAAS,KAAK,QACjE;GACE,QAAQC,gBAAAA,mBAAmB;GAC3B,OAAO,SAAS;GAChB,QAAQ,KAAK;EACf,CACF;EAGF,MAAM,OAAO,iBAAiB,MAAM;GAClC,eAAe,KAAK,IAAI,SAAS,mBAAmB,OAAO,IAAI;GAC/D,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC7B,CAAC;EAED,OAAO;GACL,QAAQC,sBAAAA,kBAFK,SAAS,MAAM,IAEG,GAAG;IAChC,GAAI,SAAS,aAAa,KAAA,IAAY,EAAE,UAAU,SAAS,SAAS,IAAI,CAAC;IACzE,mBAAmB,SAAS;IAC5B,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;GAC7B,CAAC;GACD,UAAU,QAAQ,YAAY,SAAS,IAAI;GAC3C,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;GAClE,MAAM,KAAK;GACX,aAAa;IACX,KAAK,QAAQ;GACf;EACF;CACF,EACF;CAGF,OAAO,EACL,MAAM,OAAO,EAAE,aAAa;EAC1B,MAAM,CAAC,EAAE,UAAU,QAAQ,EAAE,cAAc,MAAM,QAAQ,IAAI,CAC3D,OAAO,qBACP,OAAO,YACT,CAAC;EACD,IAAI,SAAS,aAAa,KAAA,GAAW;GACnC,MAAM,OAAO,MAAM,KAAK,IAAI;GAC5B,IAAI,KAAK,OAAO,SAAS,UACvB,MAAM,IAAIF,gBAAAA,aACR,QAAQ,KAAK,oBAAoB,SAAS,SAAS,SAAS,KAAK,QACjE;IACE,QAAQC,gBAAAA,mBAAmB;IAC3B,OAAO,SAAS;IAChB,QAAQ,KAAK;GACf,CACF;EAEJ;EAEA,MAAM,OAAO,IAAI,WAAW,MAAM,SAAS,MAAM,SAAS,EAAE,OAAO,IAAI,KAAA,CAAS,CAAC;EACjF,IAAI,SAAS,aAAa,KAAA,KAAa,KAAK,aAAa,SAAS,UAChE,MAAM,IAAID,gBAAAA,aACR,QAAQ,KAAK,oBAAoB,SAAS,SAAS,SAAS,KAAK,cACjE;GACE,QAAQC,gBAAAA,mBAAmB;GAC3B,OAAO,SAAS;GAChB,QAAQ,KAAK;EACf,CACF;EAGF,OAAO;GACL;GACA,UAAU,QAAQ,YAAY,SAAS,IAAI;GAC3C,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;EACpE;CACF,EACF;AACF;;;;;;;;;AAUA,eAAe,aAAa,MAAc,SAAS,OAAyB;CAC1E,IAAI;CACJ,IAAI;EACF,MAAM,EAAE,aAAa,MAAM,OAAO;EAClC,MAAM,MAAM,SAAS,MAAM,MAAM;CACnC,SAAS,OAAO;EACd,IAAI,aAAa,OAAO,QAAQ,GAAG,OAAO;EAC1C,MAAM;CACR;CAEA,IAAI;EACF,OAAO,KAAK,MAAM,GAAG;CACvB,QAAQ;EACN,IAAI,CAAC,QAAQ,OAAO;EACpB,MAAM,IAAIE,gBAAAA,eACR,QAAQ,KAAK,+GAEf;CACF;AACF;;;;;;;AAQA,eAAe,gBAAgB,MAAc,OAA+B;CAC1E,MAAM,EAAE,WAAW,QAAQ,WAAW,MAAM,OAAO;CAKnD,MAAM,YAAY,GAAG,KAAK,GADd,OAAO,YAAY,cAAc,QAAQ,MAAM,EAC1B,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;CAExE,IAAI;EACF,MAAM,UAAU,WAAW,KAAK,UAAU,OAAO,MAAM,CAAC,GAAG;GAAE,UAAU;GAAQ,MAAM;EAAM,CAAC;EAC5F,MAAM,OAAO,WAAW,IAAI;CAC9B,SAAS,OAAO;EACd,MAAM,OAAO,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;EACtC,MAAM;CACR;AACF;;AAGA,eAAe,WAAW,MAA6B;CACrD,MAAM,EAAE,OAAO,MAAM,OAAO;CAC5B,MAAM,GAAG,MAAM,EAAE,OAAO,KAAK,CAAC;AAChC;;;;;;;;;;;;;;;;;AAkBA,IAAa,mBAAb,MAAsD;CACpD;;;;;CAKA,WAA0B,QAAQ,QAAQ;;CAG1C,YAAY,MAAc;EACxB,KAAKC,QAAQ;CACf;CAEA,MAAM,MAAkC;EAGtC,MAAM,KAAKC,SAAS,WACZ,KAAA,SACA,KAAA,CACR;EACA,MAAM,SAAS,MAAM,aAAa,KAAKD,KAAK;EAC5C,OAAO,OAAO,WAAW,YAAY,WAAW,OAAOE,gBAAAA,YAAY,MAAoB,IAAI;CAC7F;CAEA,IAAI,SAAoC;EAGtC,MAAM,WAAWA,gBAAAA,YAAY,OAAO;EACpC,OAAO,KAAKC,eAAe,gBAAgB,KAAKH,OAAO,QAAQ,CAAC;CAClE;CAEA,QAAuB;EACrB,OAAO,KAAKG,eAAe,WAAW,KAAKH,KAAK,CAAC;CACnD;;CAGA,SAAS,WAA+C;EACtD,KAAKC,WAAW,KAAKA,SAAS,KAAK,WAAW,SAAS;EACvD,OAAO,KAAKA;CACd;AACF;;AAGA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;AAoB9B,IAAa,wBAAb,MAAgE;CAC9D;CACA;;CAGA,YAAY,MAAc;EACxB,KAAKD,QAAQ;EACb,KAAKI,SAASC,sBAAAA,yBAAyB;GACrC,YAAY,KAAKC,MAAM;GACvB,QAAQ,aAAa,gBAAgB,MAAM;IAAE,SAAS;IAAuB;GAAS,CAAC;GAEvF,cAAc,WAAW,IAAI;EAC/B,CAAC;CACH;CAEA,IAAI,SAA6C;EAC/C,OAAO,QAAQ,QAAQ,KAAKF,OAAO,IAAI,OAAO,CAAC;CACjD;CAEA,IAAI,SAAiB,SAAoC;EACvD,OAAO,QAAQ,QAAQ,KAAKA,OAAO,IAAI,SAAS,OAAO,CAAC;CAC1D;CAEA,MAAM,SAAgC;EACpC,OAAO,QAAQ,QAAQ,KAAKA,OAAO,MAAM,OAAO,CAAC;CACnD;CAEA,WAAuC;EACrC,OAAO,QAAQ,QAAQ,KAAKA,OAAO,SAAS,CAAC;CAC/C;CAEA,MAAME,QAAoD;EACxD,MAAM,SAAS,MAAM,aAAa,KAAKN,OAAO,IAAI;EAClD,IAAI,WAAW,MAAM,OAAO;EAE5B,MAAM,WACJ,OAAO,WAAW,YAAY,WAAW,OACpC,SACD,KAAA;EACN,MAAM,WAAW,UAAU;EAE3B,IACE,UAAU,YAAY,yBACtB,OAAO,aAAa,YACpB,aAAa,QACb,MAAM,QAAQ,QAAQ,GAEtB,MAAM,IAAID,gBAAAA,eACR,QAAQ,KAAKC,MAAM,uDACH,sBAAsB,+HAGxC;EAGF,OAAO;CACT;AACF"}
+{"version":3,"file":"node.cjs","names":["resolveFileStreamOptions","FileTransferMode","ItdFileError","ItdFileErrorReason","boundedFileStream","ItdConfigError","#path","#inner","createRecordKeyValueStore","#read","createTokenStorage","createMultiTokenStorage"],"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/node.d.cts

@@ -1,5 +1,5 @@
-import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.cjs";
-import { _ as StreamFile, g as LazyFile, m as FileTransferMode, n as MultiTokenStorage, p as FileStreamOptions } from "./multi-storage-DP_ujJw1.cjs";
+import { r as TokenStorage, t as ItdSession } from "./storage-BqMxs76Y.cjs";
+import { d as FileTransferMode, m as StreamFile, n as MultiTokenStorage, p as LazyFile, u as FileStreamOptions } from "./multi-storage-BUoEoW8f.cjs";
 //#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.cts.map

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-DwaIh24p.js";
+import { r as TokenStorage, t as ItdSession } from "./storage-BqMxs76Y.js";
+import { d as FileTransferMode, m as StreamFile, n as MultiTokenStorage, p as LazyFile, u as FileStreamOptions } from "./multi-storage-CQSlI_kn.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 { c as boundedFileStream, h as FileTransferMode, i as createRecordMultiStorage, s as resolveFileStreamOptions } from "./multi-storage-D4h6QA-w.js";
-import { c as ItdConfigError, f as ItdFileError, n as copySession, p as ItdFileErrorReason } from "./storage-D9tfHx7Z.js";
+import { o as resolveFileStreamOptions, p as FileTransferMode, r as createMultiTokenStorage, s as boundedFileStream } from "./multi-storage-BUZaLAPO.js";
+import { b as ItdFileErrorReason, h as ItdConfigError, r as createTokenStorage, s as createRecordKeyValueStore, y as ItdFileError } from "./storage-IHdXw52v.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