itd-api 0.0.11 → 0.2.0

package/dist/node.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/node.ts"],"names":["ItdConfigError","copySession","createRecordMultiStorage","ItdClient","ItdAccounts"],"mappings":"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","file":"node.cjs","sourcesContent":["/**\n * `itd-api/node` — то же, что `itd-api`, плюс работа с файловой системой.\n *\n * Импортируйте эту точку входа в Node, Bun и Deno: клиент отсюда умеет загружать файлы\n * по пути (`attach('./photo.jpg')`), а `FileTokenStorage` сохраняет сессию между запусками.\n * В основном бандле работы с файлами нет намеренно — иначе браузерные сборщики пытались бы\n * разрешить `node:fs`.\n *\n * @example\n * ```ts\n * import { ItdClient, FileTokenStorage } 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('./photo.jpg'));\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ItdAccounts as BaseAccounts, type ItdAccountsOptions } from './accounts.js';\nimport { ItdClient as BaseClient, type ItdClientInternals } from './client.js';\nimport { ItdConfigError } from './core/errors.js';\nimport { createRecordMultiStorage, type MultiTokenStorage } from './core/multi-storage.js';\nimport { copySession, type ItdSession, type TokenStorage } from './core/storage.js';\nimport type { FileReader } from './resources/files.js';\nimport type { ItdClientOptions } from './types/options.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/**\n * Читает файл с диска для загрузки.\n *\n * Модуль `node:fs` подключается динамически, поэтому импорт этой точки входа не тянет\n * его в браузерные сборки.\n */\nexport const nodeFileReader: FileReader = async (path) => {\n  const { readFile } = await import('node:fs/promises');\n  const { basename } = await import('node:path');\n\n  return { data: new Uint8Array(await readFile(path)), filename: basename(path) };\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\n/**\n * Клиент API итд.com с поддержкой файловой системы.\n *\n * Отличается от базового только тем, что умеет читать файлы по пути:\n * `attach('./photo.jpg')` и `itd.files.upload('./video.mp4')` работают сразу.\n */\nexport class ItdClient extends BaseClient {\n  constructor(options: ItdClientOptions = {}, internals: ItdClientInternals = {}) {\n    // Чтение файлов передаётся скрытым параметром конструктора, а не мутацией уже\n    // собранного клиента: так объект работоспособен сразу и не меняется после создания.\n    // Остальные скрытые параметры (например общая очередь от ItdAccounts) идут дальше.\n    super(options, { ...internals, fileReader: nodeFileReader });\n  }\n}\n\n/** Создаёт {@link ItdClient} с поддержкой файловой системы. */\nexport function createClient(options: ItdClientOptions = {}): ItdClient {\n  return new ItdClient(options);\n}\n\n/**\n * Несколько аккаунтов итд.com с поддержкой файловой системы.\n *\n * Отличается от базового только тем, что заводит клиентов, умеющих читать файлы по пути.\n * В паре с {@link FileMultiTokenStorage} сессии всех аккаунтов живут в одном файле.\n */\nexport class ItdAccounts extends BaseAccounts {\n  constructor(options: ItdAccountsOptions = {}) {\n    super(options, {\n      createClient: (clientOptions, internals) => new ItdClient(clientOptions, internals),\n    });\n  }\n}\n\n/** Создаёт {@link ItdAccounts} с поддержкой файловой системы. */\nexport function createAccounts(options: ItdAccountsOptions = {}): ItdAccounts {\n  return new ItdAccounts(options);\n}\n\n// Всё остальное — билдеры, типы, ошибки, перечисления — доступно отсюда же,\n// чтобы в Node хватало одного импорта. Объявленные выше имена перекрывают одноимённые.\nexport * from './index.js';\n"]}
+{"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 {\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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"}

package/dist/node.d.cts

@@ -1,34 +1,42 @@
-import { M as MultiTokenStorage, I as ItdSession, T as TokenStorage, a as ItdAccounts$1, b as ItdAccountsOptions, c as ItdClient$1, d as ItdClientOptions, e as ItdClientInternals, F as FileReader } from './index-CrlTO7sR.cjs';
-export { A as ALLOWED_MIME_TYPES, f as AUDIO_MIME_TYPES, g as AUTH_FLAG_COOKIE, h as AUTH_PATHS, i as AccessType, j as AccountEvents, k as Actor, l as AddAccountOptions, m as AllowedMimeType, n as Announcement, o as AnnouncementButton, p as Attachment, q as AttachmentType, r as AudioMimeType, s as AuthEvents, t as AuthIdentity, u as AuthInput, v as AuthResource, w as Author, x as AutoSpansOptions, B as BUILT_IN_SERVICES, y as BuilderInput, C as CaptchaCredentials, z as ChangelogEntry, D as Clan, E as ClientHooks, G as Comment, H as CommentBuilder, J as CommentInput, K as CommentReplyTo, L as CommentSort, N as CommentsParams, O as CommentsResource, P as CreateCommentInput, Q as CreatePollInput, R as CreatePostInput, S as CreateReportInput, U as Credentials, V as CredentialsAuth, W as DEFAULT_BASE_URL, X as DEFAULT_STATUS_BASE_URL, Y as DEFAULT_TIMEOUT, Z as DEFAULT_UPLOAD_TIMEOUT, _ as DEFAULT_USER_AGENT, $ as DEVICE_ID_HEADER, a0 as DetectedRuntime, a1 as DwellEntry, a2 as ErrorContextHook, a3 as FeedParams, a4 as FeedTab, a5 as FileInput, a6 as FilesResource, a7 as FollowResult, a8 as ForgotPasswordInput, a9 as Hashtag, aa as HashtagPostsParams, ab as HashtagsResource, ac as IMAGE_MIME_TYPES, ad as ImageMimeType, ae as IncidentKind, af as InteractionEntry, ag as InteractionType, ah as IsoDate, ai as ItdAbortError, aj as ItdApiError, ak as ItdApiErrorInit, al as ItdApiErrorKind, am as ItdAuthError, an as ItdBuilder, ao as ItdConfigError, ap as ItdConflictError, aq as ItdError, ar as ItdErrorCode, as as ItdErrorKind, at as ItdFieldErrors, au as ItdForbiddenError, av as ItdNetworkError, aw as ItdNotFoundError, ax as ItdPhoneVerificationError, ay as ItdPlugin, az as ItdRateLimitError, aA as ItdRealtime, aB as ItdServerError, aC as ItdTimeoutError, aD as ItdValidationError, aE as LIBRARY_VERSION, aF as LikeResult, aG as LikesVisibility, aH as Listener, aI as LocalStorageTokenStorage, aJ as Logger, aK as Loose, aL as MAX_RECONNECT_ATTEMPTS, aM as MarkupBuilder, aN as MarkupContent, aO as MarkupInput, aP as MarkupSpan, aQ as MemoryMultiTokenStorage, aR as MemoryTokenStorage, aS as MyProfile, aT as NOTIFICATION_TYPE_ALIASES, aU as Notification, aV as NotificationEvent, aW as NotificationListParams, aX as NotificationSettings, aY as NotificationType, aZ as NotificationsResource, a_ as OAuthProvider, a$ as Page, b0 as PageState, b1 as PaginationMode, b2 as Paginator, b3 as PaginatorOptions, b4 as PaymentMethod, b5 as Pin, b6 as PinPostResult, b7 as PinsResult, b8 as PlatformResource, b9 as PlatformStatus, ba as PluginContext, bb as Poll, bc as PollBuilder, bd as PollInput, be as PollOption, bf as PollTransportOptions, bg as Portal, bh as Post, bi as PostBuilder, bj as PostInput, bk as PostStats, bl as PostUpdateInput, bm as PostsResource, bn as PrivacySettings, bo as Profile, bp as PublicProfile, bq as QueryParams, br as QueryValue, bs as RECONNECT_BACKOFF, bt as RECONNECT_JITTER, bu as REFRESH_COOKIE, bv as REFRESH_COOKIE_PATH, bw as REQUEST_OPTION_KEYS, bx as RateLimitOptions, by as RateLimitScope, bz as RawRequestOptions, bA as RealtimeDeps, bB as RealtimeEvents, bC as RealtimeOptions, bD as RealtimeStatus, bE as RealtimeTransport, bF as RealtimeTransportKind, bG as ReconnectOptions, bH as RecordStorageSource, bI as RemoveAccountOptions, bJ as RenderSpansOptions, bK as RepliesParams, bL as Report, bM as ReportBuilder, bN as ReportInput, bO as ReportReason, bP as ReportTargetType, bQ as ReportsResource, bR as RequestContext, bS as RequestOptions, bT as ResetPasswordInput, bU as ResponseContext, bV as RetryContext, bW as RetryOptions, bX as RuntimeMode, bY as STATUS_SERVICE, bZ as STREAM_PATH, b_ as SearchResource, b$ as SearchResult, c0 as ServiceDefinition, c1 as ServiceRegistry, c2 as ServiceState, c3 as ServiceStatus, c4 as Session, c5 as SignInResult, c6 as SignInStatus, c7 as Span, c8 as SpanRenderFormat, c9 as SpanType, ca as SseTransportOptions, cb as StatusDay, cc as StatusIncidentLine, cd as Subscription, ce as SubscriptionResource, cf as SubscriptionState, cg as TURNSTILE_SITE_KEY, ch as TelemetryOptions, ci as TelemetryResource, cj as TextMarkup, ck as Transformer, cl as TransportContext, cm as TransportEvent, cn as UnauthorizedStreamError, co as Unsubscribe, cp as UpdateNotificationSettingsInput, cq as UpdatePostInput, cr as UpdatePrivacyInput, cs as UpdateProfileInput, ct as UploadOptions, cu as UploadedFile, cv as UserId, cw as UserListParams, cx as UserPostsParams, cy as UserRef, cz as UserSummary, cA as UsersResource, cB as VIDEO_MIME_TYPES, cC as VerificationResource, cD as VerificationStatus, cE as VideoMimeType, cF as ViewReason, cG as ViewSource, cH as WallAccess, cI as autoSpans, cJ as canonicalNotificationType, cK as comment, cL as createMultiTokenStorage, cM as createRecordMultiStorage, cN as createTokenStorage, cO as formatNotificationText, cP as isBuilder, cQ as isItdApiError, cR as isItdAuthError, cS as isItdConflictError, cT as isItdError, cU as isItdForbiddenError, cV as isItdNotFoundError, cW as isItdPhoneVerificationError, cX as isItdRateLimitError, cY as isItdServerError, cZ as isItdValidationError, c_ as isKnownNotificationType, c$ as isMyProfile, d0 as mapPage, d1 as markup, d2 as normalizeNotification, d3 as poll, d4 as post, d5 as readNotificationEvent, d6 as readUnreadCountEvent, d7 as renderSpans, d8 as report, d9 as resolveNotificationUrl, da as scopedTokenStorage, db as statusDays, dc as toDate, dd as utcStampToIso } from './index-CrlTO7sR.cjs';
-
+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-NDqzRQcD.cjs";
+//#region src/node.d.ts
+/** Что можно уточнить у файла с диска. */
+interface PathFileOptions extends FileStreamOptions {
+  /** Имя файла. По умолчанию — имя из пути. */
+  filename?: string | undefined;
+  /** MIME-тип. По умолчанию определяется по расширению. */
+  contentType?: string | undefined;
+}
 /**
- * `itd-api/node` — то же, что `itd-api`, плюс работа с файловой системой.
+ * Вложение из файла на диске.
+ *
+ * Клиент настраивать не нужно: чтение диска приезжает вместе со значением, а не через
+ * опцию, поэтому один и тот же клиент принимает и файлы с диска, и всё остальное.
  *
- * Импортируйте эту точку входа в Node, Bun и Deno: клиент отсюда умеет загружать файлы
- * по пути (`attach('./photo.jpg')`), а `FileTokenStorage` сохраняет сессию между запусками.
- * В основном бандле работы с файлами нет намеренно — иначе браузерные сборщики пытались бы
- * разрешить `node:fs`.
+ * По умолчанию файл читается целиком непосредственно перед отправкой. Режим
+ * `{ mode: 'stream' }` передаёт его частями и открывает заново при повторной попытке.
+ * Модуль `node:fs` подключается динамически.
  *
  * @example
  * ```ts
- * import { ItdClient, FileTokenStorage } from 'itd-api/node';
+ * import { ItdClient } from 'itd-api';
+ * import { fromPath } from 'itd-api/node';
  *
- * // Когда сессия уже сохранена, `auth` не нужен — токен возьмётся из хранилища.
- * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });
+ * const itd = new ItdClient({ auth });
  *
- * await itd.posts.create((p) => p.content('привет').attach('./photo.jpg'));
+ * await itd.posts.create((p) =>
+ *   p.content('смотрите').attach(fromPath('./photo.jpg')),
+ * );
  * ```
- *
- * @packageDocumentation
  */
-
-/**
- * Читает файл с диска для загрузки.
- *
- * Модуль `node:fs` подключается динамически, поэтому импорт этой точки входа не тянет
- * его в браузерные сборки.
- */
-declare const nodeFileReader: FileReader;
+declare function fromPath(path: string, options: PathFileOptions & {
+  mode: typeof FileTransferMode.Stream;
+}): StreamFile;
+declare function fromPath(path: string, options?: PathFileOptions & {
+  mode?: typeof FileTransferMode.Buffer;
+}): LazyFile;
+declare function fromPath(path: string, options: PathFileOptions): LazyFile | StreamFile;
 /**
  * Хранит сессию в файле.
  *
@@ -46,12 +54,12 @@ declare const nodeFileReader: FileReader;
  * ```
  */
 declare class FileTokenStorage implements TokenStorage {
-    #private;
-    /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
-    constructor(path: string);
-    get(): Promise<ItdSession | null>;
-    set(session: ItdSession): Promise<void>;
-    clear(): Promise<void>;
+  #private;
+  /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
+  constructor(path: string);
+  get(): Promise<ItdSession | null>;
+  set(session: ItdSession): Promise<void>;
+  clear(): Promise<void>;
 }
 /**
  * Хранит сессии нескольких аккаунтов в одном файле.
@@ -72,35 +80,14 @@ declare class FileTokenStorage implements TokenStorage {
  * ```
  */
 declare class FileMultiTokenStorage implements MultiTokenStorage {
-    #private;
-    /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
-    constructor(path: string);
-    get(account: string): Promise<ItdSession | null>;
-    set(account: string, session: ItdSession): Promise<void>;
-    clear(account: string): Promise<void>;
-    accounts(): Promise<readonly string[]>;
-}
-/**
- * Клиент API итд.com с поддержкой файловой системы.
- *
- * Отличается от базового только тем, что умеет читать файлы по пути:
- * `attach('./photo.jpg')` и `itd.files.upload('./video.mp4')` работают сразу.
- */
-declare class ItdClient extends ItdClient$1 {
-    constructor(options?: ItdClientOptions, internals?: ItdClientInternals);
-}
-/** Создаёт {@link ItdClient} с поддержкой файловой системы. */
-declare function createClient(options?: ItdClientOptions): ItdClient;
-/**
- * Несколько аккаунтов итд.com с поддержкой файловой системы.
- *
- * Отличается от базового только тем, что заводит клиентов, умеющих читать файлы по пути.
- * В паре с {@link FileMultiTokenStorage} сессии всех аккаунтов живут в одном файле.
- */
-declare class ItdAccounts extends ItdAccounts$1 {
-    constructor(options?: ItdAccountsOptions);
+  #private;
+  /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
+  constructor(path: string);
+  get(account: string): Promise<ItdSession | null>;
+  set(account: string, session: ItdSession): Promise<void>;
+  clear(account: string): Promise<void>;
+  accounts(): Promise<readonly string[]>;
 }
-/** Создаёт {@link ItdAccounts} с поддержкой файловой системы. */
-declare function createAccounts(options?: ItdAccountsOptions): ItdAccounts;
-
-export { FileMultiTokenStorage, FileReader, FileTokenStorage, ItdAccounts, ItdAccountsOptions, ItdClient, ItdClientOptions, ItdSession, MultiTokenStorage, TokenStorage, createAccounts, createClient, nodeFileReader };
+//#endregion
+export { FileMultiTokenStorage, FileTokenStorage, PathFileOptions, fromPath };
+//# sourceMappingURL=node.d.cts.map

package/dist/node.d.ts

@@ -1,34 +1,42 @@
-import { M as MultiTokenStorage, I as ItdSession, T as TokenStorage, a as ItdAccounts$1, b as ItdAccountsOptions, c as ItdClient$1, d as ItdClientOptions, e as ItdClientInternals, F as FileReader } from './index-CrlTO7sR.js';
-export { A as ALLOWED_MIME_TYPES, f as AUDIO_MIME_TYPES, g as AUTH_FLAG_COOKIE, h as AUTH_PATHS, i as AccessType, j as AccountEvents, k as Actor, l as AddAccountOptions, m as AllowedMimeType, n as Announcement, o as AnnouncementButton, p as Attachment, q as AttachmentType, r as AudioMimeType, s as AuthEvents, t as AuthIdentity, u as AuthInput, v as AuthResource, w as Author, x as AutoSpansOptions, B as BUILT_IN_SERVICES, y as BuilderInput, C as CaptchaCredentials, z as ChangelogEntry, D as Clan, E as ClientHooks, G as Comment, H as CommentBuilder, J as CommentInput, K as CommentReplyTo, L as CommentSort, N as CommentsParams, O as CommentsResource, P as CreateCommentInput, Q as CreatePollInput, R as CreatePostInput, S as CreateReportInput, U as Credentials, V as CredentialsAuth, W as DEFAULT_BASE_URL, X as DEFAULT_STATUS_BASE_URL, Y as DEFAULT_TIMEOUT, Z as DEFAULT_UPLOAD_TIMEOUT, _ as DEFAULT_USER_AGENT, $ as DEVICE_ID_HEADER, a0 as DetectedRuntime, a1 as DwellEntry, a2 as ErrorContextHook, a3 as FeedParams, a4 as FeedTab, a5 as FileInput, a6 as FilesResource, a7 as FollowResult, a8 as ForgotPasswordInput, a9 as Hashtag, aa as HashtagPostsParams, ab as HashtagsResource, ac as IMAGE_MIME_TYPES, ad as ImageMimeType, ae as IncidentKind, af as InteractionEntry, ag as InteractionType, ah as IsoDate, ai as ItdAbortError, aj as ItdApiError, ak as ItdApiErrorInit, al as ItdApiErrorKind, am as ItdAuthError, an as ItdBuilder, ao as ItdConfigError, ap as ItdConflictError, aq as ItdError, ar as ItdErrorCode, as as ItdErrorKind, at as ItdFieldErrors, au as ItdForbiddenError, av as ItdNetworkError, aw as ItdNotFoundError, ax as ItdPhoneVerificationError, ay as ItdPlugin, az as ItdRateLimitError, aA as ItdRealtime, aB as ItdServerError, aC as ItdTimeoutError, aD as ItdValidationError, aE as LIBRARY_VERSION, aF as LikeResult, aG as LikesVisibility, aH as Listener, aI as LocalStorageTokenStorage, aJ as Logger, aK as Loose, aL as MAX_RECONNECT_ATTEMPTS, aM as MarkupBuilder, aN as MarkupContent, aO as MarkupInput, aP as MarkupSpan, aQ as MemoryMultiTokenStorage, aR as MemoryTokenStorage, aS as MyProfile, aT as NOTIFICATION_TYPE_ALIASES, aU as Notification, aV as NotificationEvent, aW as NotificationListParams, aX as NotificationSettings, aY as NotificationType, aZ as NotificationsResource, a_ as OAuthProvider, a$ as Page, b0 as PageState, b1 as PaginationMode, b2 as Paginator, b3 as PaginatorOptions, b4 as PaymentMethod, b5 as Pin, b6 as PinPostResult, b7 as PinsResult, b8 as PlatformResource, b9 as PlatformStatus, ba as PluginContext, bb as Poll, bc as PollBuilder, bd as PollInput, be as PollOption, bf as PollTransportOptions, bg as Portal, bh as Post, bi as PostBuilder, bj as PostInput, bk as PostStats, bl as PostUpdateInput, bm as PostsResource, bn as PrivacySettings, bo as Profile, bp as PublicProfile, bq as QueryParams, br as QueryValue, bs as RECONNECT_BACKOFF, bt as RECONNECT_JITTER, bu as REFRESH_COOKIE, bv as REFRESH_COOKIE_PATH, bw as REQUEST_OPTION_KEYS, bx as RateLimitOptions, by as RateLimitScope, bz as RawRequestOptions, bA as RealtimeDeps, bB as RealtimeEvents, bC as RealtimeOptions, bD as RealtimeStatus, bE as RealtimeTransport, bF as RealtimeTransportKind, bG as ReconnectOptions, bH as RecordStorageSource, bI as RemoveAccountOptions, bJ as RenderSpansOptions, bK as RepliesParams, bL as Report, bM as ReportBuilder, bN as ReportInput, bO as ReportReason, bP as ReportTargetType, bQ as ReportsResource, bR as RequestContext, bS as RequestOptions, bT as ResetPasswordInput, bU as ResponseContext, bV as RetryContext, bW as RetryOptions, bX as RuntimeMode, bY as STATUS_SERVICE, bZ as STREAM_PATH, b_ as SearchResource, b$ as SearchResult, c0 as ServiceDefinition, c1 as ServiceRegistry, c2 as ServiceState, c3 as ServiceStatus, c4 as Session, c5 as SignInResult, c6 as SignInStatus, c7 as Span, c8 as SpanRenderFormat, c9 as SpanType, ca as SseTransportOptions, cb as StatusDay, cc as StatusIncidentLine, cd as Subscription, ce as SubscriptionResource, cf as SubscriptionState, cg as TURNSTILE_SITE_KEY, ch as TelemetryOptions, ci as TelemetryResource, cj as TextMarkup, ck as Transformer, cl as TransportContext, cm as TransportEvent, cn as UnauthorizedStreamError, co as Unsubscribe, cp as UpdateNotificationSettingsInput, cq as UpdatePostInput, cr as UpdatePrivacyInput, cs as UpdateProfileInput, ct as UploadOptions, cu as UploadedFile, cv as UserId, cw as UserListParams, cx as UserPostsParams, cy as UserRef, cz as UserSummary, cA as UsersResource, cB as VIDEO_MIME_TYPES, cC as VerificationResource, cD as VerificationStatus, cE as VideoMimeType, cF as ViewReason, cG as ViewSource, cH as WallAccess, cI as autoSpans, cJ as canonicalNotificationType, cK as comment, cL as createMultiTokenStorage, cM as createRecordMultiStorage, cN as createTokenStorage, cO as formatNotificationText, cP as isBuilder, cQ as isItdApiError, cR as isItdAuthError, cS as isItdConflictError, cT as isItdError, cU as isItdForbiddenError, cV as isItdNotFoundError, cW as isItdPhoneVerificationError, cX as isItdRateLimitError, cY as isItdServerError, cZ as isItdValidationError, c_ as isKnownNotificationType, c$ as isMyProfile, d0 as mapPage, d1 as markup, d2 as normalizeNotification, d3 as poll, d4 as post, d5 as readNotificationEvent, d6 as readUnreadCountEvent, d7 as renderSpans, d8 as report, d9 as resolveNotificationUrl, da as scopedTokenStorage, db as statusDays, dc as toDate, dd as utcStampToIso } from './index-CrlTO7sR.js';
-
+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";
+//#region src/node.d.ts
+/** Что можно уточнить у файла с диска. */
+interface PathFileOptions extends FileStreamOptions {
+  /** Имя файла. По умолчанию — имя из пути. */
+  filename?: string | undefined;
+  /** MIME-тип. По умолчанию определяется по расширению. */
+  contentType?: string | undefined;
+}
 /**
- * `itd-api/node` — то же, что `itd-api`, плюс работа с файловой системой.
+ * Вложение из файла на диске.
+ *
+ * Клиент настраивать не нужно: чтение диска приезжает вместе со значением, а не через
+ * опцию, поэтому один и тот же клиент принимает и файлы с диска, и всё остальное.
  *
- * Импортируйте эту точку входа в Node, Bun и Deno: клиент отсюда умеет загружать файлы
- * по пути (`attach('./photo.jpg')`), а `FileTokenStorage` сохраняет сессию между запусками.
- * В основном бандле работы с файлами нет намеренно — иначе браузерные сборщики пытались бы
- * разрешить `node:fs`.
+ * По умолчанию файл читается целиком непосредственно перед отправкой. Режим
+ * `{ mode: 'stream' }` передаёт его частями и открывает заново при повторной попытке.
+ * Модуль `node:fs` подключается динамически.
  *
  * @example
  * ```ts
- * import { ItdClient, FileTokenStorage } from 'itd-api/node';
+ * import { ItdClient } from 'itd-api';
+ * import { fromPath } from 'itd-api/node';
  *
- * // Когда сессия уже сохранена, `auth` не нужен — токен возьмётся из хранилища.
- * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });
+ * const itd = new ItdClient({ auth });
  *
- * await itd.posts.create((p) => p.content('привет').attach('./photo.jpg'));
+ * await itd.posts.create((p) =>
+ *   p.content('смотрите').attach(fromPath('./photo.jpg')),
+ * );
  * ```
- *
- * @packageDocumentation
  */
-
-/**
- * Читает файл с диска для загрузки.
- *
- * Модуль `node:fs` подключается динамически, поэтому импорт этой точки входа не тянет
- * его в браузерные сборки.
- */
-declare const nodeFileReader: FileReader;
+declare function fromPath(path: string, options: PathFileOptions & {
+  mode: typeof FileTransferMode.Stream;
+}): StreamFile;
+declare function fromPath(path: string, options?: PathFileOptions & {
+  mode?: typeof FileTransferMode.Buffer;
+}): LazyFile;
+declare function fromPath(path: string, options: PathFileOptions): LazyFile | StreamFile;
 /**
  * Хранит сессию в файле.
  *
@@ -46,12 +54,12 @@ declare const nodeFileReader: FileReader;
  * ```
  */
 declare class FileTokenStorage implements TokenStorage {
-    #private;
-    /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
-    constructor(path: string);
-    get(): Promise<ItdSession | null>;
-    set(session: ItdSession): Promise<void>;
-    clear(): Promise<void>;
+  #private;
+  /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
+  constructor(path: string);
+  get(): Promise<ItdSession | null>;
+  set(session: ItdSession): Promise<void>;
+  clear(): Promise<void>;
 }
 /**
  * Хранит сессии нескольких аккаунтов в одном файле.
@@ -72,35 +80,14 @@ declare class FileTokenStorage implements TokenStorage {
  * ```
  */
 declare class FileMultiTokenStorage implements MultiTokenStorage {
-    #private;
-    /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
-    constructor(path: string);
-    get(account: string): Promise<ItdSession | null>;
-    set(account: string, session: ItdSession): Promise<void>;
-    clear(account: string): Promise<void>;
-    accounts(): Promise<readonly string[]>;
-}
-/**
- * Клиент API итд.com с поддержкой файловой системы.
- *
- * Отличается от базового только тем, что умеет читать файлы по пути:
- * `attach('./photo.jpg')` и `itd.files.upload('./video.mp4')` работают сразу.
- */
-declare class ItdClient extends ItdClient$1 {
-    constructor(options?: ItdClientOptions, internals?: ItdClientInternals);
-}
-/** Создаёт {@link ItdClient} с поддержкой файловой системы. */
-declare function createClient(options?: ItdClientOptions): ItdClient;
-/**
- * Несколько аккаунтов итд.com с поддержкой файловой системы.
- *
- * Отличается от базового только тем, что заводит клиентов, умеющих читать файлы по пути.
- * В паре с {@link FileMultiTokenStorage} сессии всех аккаунтов живут в одном файле.
- */
-declare class ItdAccounts extends ItdAccounts$1 {
-    constructor(options?: ItdAccountsOptions);
+  #private;
+  /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
+  constructor(path: string);
+  get(account: string): Promise<ItdSession | null>;
+  set(account: string, session: ItdSession): Promise<void>;
+  clear(account: string): Promise<void>;
+  accounts(): Promise<readonly string[]>;
 }
-/** Создаёт {@link ItdAccounts} с поддержкой файловой системы. */
-declare function createAccounts(options?: ItdAccountsOptions): ItdAccounts;
-
-export { FileMultiTokenStorage, FileReader, FileTokenStorage, ItdAccounts, ItdAccountsOptions, ItdClient, ItdClientOptions, ItdSession, MultiTokenStorage, TokenStorage, createAccounts, createClient, nodeFileReader };
+//#endregion
+export { FileMultiTokenStorage, FileTokenStorage, PathFileOptions, fromPath };
+//# sourceMappingURL=node.d.ts.map