itd-api 0.7.0 → 0.7.1

package/dist/{node.cjs → node/index.cjs}

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_multi_storage = require("./multi-storage-Bf84xiO8.cjs");
-const require_storage = require("./storage-DnzZPS_9.cjs");
+const require_errors = require("../shared/errors-DfU8M5eS.cjs");
+const require_storage = require("../shared/storage-BPJR_k4-.cjs");
+const require_options = require("../shared/options-Dg5N3r1V.cjs");
+const require_multi_storage = require("../shared/multi-storage--yTEqiod.cjs");
 //#region src/node.ts
 /**
 * `itd-api/node` — файловая система для Node, Bun и Deno.
@@ -27,8 +29,8 @@ function hasErrorCode(error, code) {
 	return typeof error === "object" && error !== null && "code" in error && error.code === code;
 }
 function fromPath(path, options = {}) {
-	const resolved = require_multi_storage.resolveFileStreamOptions(options);
-	if (resolved.mode === require_multi_storage.FileTransferMode.Stream) return { open: async ({ signal }) => {
+	const resolved = require_options.resolveFileStreamOptions(options);
+	if (resolved.mode === require_options.FileTransferMode.Stream) return { open: async ({ signal }) => {
 		const [{ createReadStream }, { stat }, { basename }, { Readable }] = await Promise.all([
 			import("node:fs"),
 			import("node:fs/promises"),
@@ -36,8 +38,8 @@ function fromPath(path, options = {}) {
 			import("node:stream")
 		]);
 		const info = await stat(path);
-		if (resolved.maxBytes !== void 0 && info.size > resolved.maxBytes) throw new require_storage.ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`, {
-			reason: require_storage.ItdFileErrorReason.TooLarge,
+		if (resolved.maxBytes !== void 0 && info.size > resolved.maxBytes) throw new require_errors.ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`, {
+			reason: require_errors.ItdFileErrorReason.TooLarge,
 			limit: resolved.maxBytes,
 			actual: info.size
 		});
@@ -47,7 +49,7 @@ function fromPath(path, options = {}) {
 		});
 		const source = Readable.toWeb(file);
 		return {
-			stream: require_multi_storage.boundedFileStream(source, {
+			stream: require_options.boundedFileStream(source, {
 				...resolved.maxBytes !== void 0 ? { maxBytes: resolved.maxBytes } : {},
 				streamBufferBytes: resolved.streamBufferBytes,
 				...signal ? { signal } : {}
@@ -64,15 +66,15 @@ function fromPath(path, options = {}) {
 		const [{ readFile, stat }, { basename }] = await Promise.all([import("node:fs/promises"), import("node:path")]);
 		if (resolved.maxBytes !== void 0) {
 			const info = await stat(path);
-			if (info.size > resolved.maxBytes) throw new require_storage.ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`, {
-				reason: require_storage.ItdFileErrorReason.TooLarge,
+			if (info.size > resolved.maxBytes) throw new require_errors.ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`, {
+				reason: require_errors.ItdFileErrorReason.TooLarge,
 				limit: resolved.maxBytes,
 				actual: info.size
 			});
 		}
 		const file = new Uint8Array(await readFile(path, signal ? { signal } : void 0));
-		if (resolved.maxBytes !== void 0 && file.byteLength > resolved.maxBytes) throw new require_storage.ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${file.byteLength}`, {
-			reason: require_storage.ItdFileErrorReason.TooLarge,
+		if (resolved.maxBytes !== void 0 && file.byteLength > resolved.maxBytes) throw new require_errors.ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${file.byteLength}`, {
+			reason: require_errors.ItdFileErrorReason.TooLarge,
 			limit: resolved.maxBytes,
 			actual: file.byteLength
 		});
@@ -101,7 +103,7 @@ async function readJsonFile(path) {
 	try {
 		return JSON.parse(raw);
 	} catch {
-		throw new require_storage.ItdConfigError(`Файл ${path} повреждён: ожидался JSON key-value хранилища. Исправьте файл или перенесите его перед следующим сохранением.`);
+		throw new require_errors.ItdConfigError(`Файл ${path} повреждён: ожидался JSON key-value хранилища. Исправьте файл или перенесите его перед следующим сохранением.`);
 	}
 }
 /**
@@ -168,7 +170,7 @@ var FileKeyValueStore = class {
 		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 }. Возьмите другой путь, чтобы не перезаписать посторонние данные.`);
+		if (envelope?.version !== FILE_STORE_VERSION || typeof envelope.values !== "object" || envelope.values === null || Array.isArray(envelope.values)) throw new require_errors.ItdConfigError(`Файл ${this.#path} имеет неподдерживаемый формат: ожидается { version: ${FILE_STORE_VERSION}, values }. Возьмите другой путь, чтобы не перезаписать посторонние данные.`);
 		return envelope.values;
 	}
 };
@@ -246,4 +248,4 @@ exports.FileMultiTokenStorage = FileMultiTokenStorage;
 exports.FileTokenStorage = FileTokenStorage;
 exports.fromPath = fromPath;
 
-//# sourceMappingURL=node.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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 './session/multi-storage.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './session/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 → node/index.d.cts}

@@ -1,5 +1,6 @@
-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";
+import { r as TokenStorage, t as ItdSession } from "../shared/storage-C_eICCep.cjs";
+import { a as FileStreamOptions, c as LazyFile, l as StreamFile, o as FileTransferMode } from "../shared/contracts-BoT7msmq.cjs";
+import { n as MultiTokenStorage } from "../shared/multi-storage-CjAPB5Kq.cjs";
 //#region src/node.d.ts
 /** Что можно уточнить у файла с диска. */
 interface PathFileOptions extends FileStreamOptions {
@@ -104,4 +105,4 @@ declare class FileMultiTokenStorage implements MultiTokenStorage {
 }
 //#endregion
 export { FileKeyValueStore, FileMultiTokenStorage, FileTokenStorage, PathFileOptions, fromPath };
-//# sourceMappingURL=node.d.cts.map
+//# sourceMappingURL=index.d.cts.map

package/dist/{node.d.ts → node/index.d.ts}

@@ -1,5 +1,6 @@
-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";
+import { r as TokenStorage, t as ItdSession } from "../shared/storage-C_eICCep.js";
+import { a as FileStreamOptions, c as LazyFile, l as StreamFile, o as FileTransferMode } from "../shared/contracts-BoT7msmq.js";
+import { n as MultiTokenStorage } from "../shared/multi-storage-DccjD7Ww.js";
 //#region src/node.d.ts
 /** Что можно уточнить у файла с диска. */
 interface PathFileOptions extends FileStreamOptions {
@@ -104,4 +105,4 @@ declare class FileMultiTokenStorage implements MultiTokenStorage {
 }
 //#endregion
 export { FileKeyValueStore, FileMultiTokenStorage, FileTokenStorage, PathFileOptions, fromPath };
-//# sourceMappingURL=node.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/{node.js → node/index.js}

@@ -1,5 +1,7 @@
-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";
+import { a as ItdConfigError, l as ItdFileError, u as ItdFileErrorReason } from "../shared/errors-Bhrd2fJd.js";
+import { r as createTokenStorage, s as createRecordKeyValueStore } from "../shared/storage-D86edNCB.js";
+import { c as FileTransferMode, n as boundedFileStream, t as resolveFileStreamOptions } from "../shared/options-DtATYdLr.js";
+import { r as createMultiTokenStorage } from "../shared/multi-storage-CkvTUC5m.js";
 //#region src/node.ts
 /**
 * `itd-api/node` — файловая система для Node, Bun и Deno.
@@ -242,4 +244,4 @@ var FileMultiTokenStorage = class {
 //#endregion
 export { FileKeyValueStore, FileMultiTokenStorage, FileTokenStorage, fromPath };
 
-//# sourceMappingURL=node.js.map
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#path","#inner","#read"],"sources":["../../src/node.ts"],"sourcesContent":["/**\n * `itd-api/node` — файловая система для Node, Bun и Deno.\n *\n * Здесь лежит только то, что требует `node:fs` и потому не может попасть в основной бандл:\n * иначе браузерные сборщики пытались бы разрешить этот модуль. Клиент, аккаунты, билдеры,\n * типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { FileTokenStorage, fromPath } from 'itd-api/node';\n *\n * // Когда сессия уже сохранена, `auth` не нужен — токен возьмётся из хранилища.\n * const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });\n *\n * await itd.posts.create((p) => p.content('привет').attach(fromPath('./photo.jpg')));\n * ```\n *\n * @packageDocumentation\n */\n\nimport { boundedFileStream } from './core/attachments/bounded-stream.js';\nimport {\n  type FileStreamOptions,\n  FileTransferMode,\n  type LazyFile,\n  type StreamFile,\n} from './core/attachments/contracts.js';\nimport { resolveFileStreamOptions } from './core/attachments/options.js';\nimport { ItdConfigError, ItdFileError, ItdFileErrorReason } from './core/errors.js';\nimport { createRecordKeyValueStore, type EnumerableKeyValueStore } from './core/key-value-store.js';\nimport { createMultiTokenStorage, type MultiTokenStorage } from './session/multi-storage.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './session/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/realtime/index.cjs

@@ -0,0 +1,165 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_url = require("../shared/url-yjl2c8Ie.cjs");
+const require_errors = require("../shared/errors-DfU8M5eS.cjs");
+const require_websocket = require("../shared/websocket-sYlynrr0.cjs");
+const require_auth_provider = require("../shared/auth-provider-CTJkKfgy.cjs");
+//#region src/realtime/client.ts
+/**
+* Поток уведомлений с собственным конвейером запросов.
+*
+* Тот же {@link ItdRealtime}, что отдаёт `itd.realtime()`, но собранный без полного клиента:
+* ресурсы, билдеры и сессия сюда не входят. Нужен приложениям, которым от API нужны только
+* события, — виджетам, счётчикам непрочитанного, фоновым слушателям.
+*
+* @example
+* ```ts
+* import { createRealtimeClient } from 'itd-api/realtime';
+*
+* await using stream = createRealtimeClient({ auth: token });
+* stream.on('notification', ({ notification }) => console.log(notification.type));
+* await stream.connect();
+* ```
+*/
+var ItdRealtimeClient = class ItdRealtimeClient extends require_websocket.ItdRealtime {
+	#runtime;
+	/** Общий результат терминальной очистки для идемпотентных повторных вызовов. */
+	#disposePromise;
+	#disposed = false;
+	constructor(options = {}) {
+		const runtime = require_url.createClientRuntime(options, {
+			catalog: require_url.ITD_CATALOG,
+			auth: () => resolveAuthProvider(options.auth)
+		});
+		super(realtimeDeps(runtime), options);
+		this.#runtime = runtime;
+		require_websocket.setRealtimeConnectGuard(this, () => {
+			if (!this.#disposed) return;
+			throw new require_errors.ItdStateError("Поток уже окончательно освобождён через dispose(); нельзя подключить его снова. Создайте новый");
+		});
+	}
+	/**
+	* Окончательно освобождает поток и его конвейер: отключает соединение, дожидается
+	* обработчиков и останавливает очередь запросов.
+	*
+	* Повторные вызовы возвращают тот же результат очистки.
+	*/
+	dispose() {
+		if (this.#disposePromise) return this.#disposePromise;
+		this.#disposed = true;
+		this.#disposePromise = this.#dispose();
+		return this.#disposePromise;
+	}
+	async #dispose() {
+		const errors = [];
+		this.disconnect();
+		try {
+			await this.drain();
+		} catch (error) {
+			errors.push(error);
+		}
+		try {
+			this.#runtime.close();
+			await this.#runtime.dispose();
+		} catch (error) {
+			errors.push(error);
+		}
+		if (errors.length > 0) throw new AggregateError(errors, "Не удалось освободить поток");
+	}
+	/** Позволяет использовать поток с `await using`. */
+	[Symbol.asyncDispose]() {
+		return this.dispose();
+	}
+	static {
+		require_url.installAsyncDisposeFallback(ItdRealtimeClient);
+	}
+};
+/** Приводит опцию `auth` к провайдеру конвейера. */
+function resolveAuthProvider(auth) {
+	if (auth === void 0) return require_auth_provider.anonymousAuth();
+	return typeof auth === "string" ? require_auth_provider.bearerToken(auth) : auth;
+}
+/**
+* Связывает поток с собранным конвейером.
+*
+* Начальный счётчик непрочитанных берётся той же операцией, что и при опросе
+* (`realtime.poll.unread`): ресурс уведомлений потоку для этого не нужен.
+*/
+function realtimeDeps(runtime) {
+	const request = ({ operationId, path, query, signal }) => runtime.http.operation(operationId, {
+		path,
+		query,
+		signal
+	});
+	return {
+		baseUrl: runtime.config.baseUrl,
+		fetch: runtime.config.fetch,
+		clock: runtime.config.clock,
+		logger: runtime.config.logger,
+		request,
+		baseHeaders: (url) => runtime.platformHeaders(url),
+		getToken: () => runtime.auth.token(),
+		refresh: () => runtime.auth.recover(),
+		fetchUnreadCount: async () => {
+			const payload = await request({
+				operationId: "realtime.poll.unread",
+				path: "/api/notifications/count"
+			});
+			return require_url.pickNumber(payload, "count", 0);
+		}
+	};
+}
+/**
+* Создаёт поток уведомлений с собственным конвейером. Равнозначно конструктору
+* {@link ItdRealtimeClient}.
+*/
+function createRealtimeClient(options = {}) {
+	return new ItdRealtimeClient(options);
+}
+//#endregion
+exports.DEFAULT_BASE_URL = require_url.DEFAULT_BASE_URL;
+exports.ItdAbortError = require_errors.ItdAbortError;
+exports.ItdApiError = require_errors.ItdApiError;
+exports.ItdApiErrorKind = require_errors.ItdApiErrorKind;
+exports.ItdAuthError = require_errors.ItdAuthError;
+exports.ItdConfigError = require_errors.ItdConfigError;
+exports.ItdError = require_errors.ItdError;
+exports.ItdErrorKind = require_errors.ItdErrorKind;
+exports.ItdForbiddenError = require_errors.ItdForbiddenError;
+exports.ItdNetworkError = require_errors.ItdNetworkError;
+exports.ItdNotFoundError = require_errors.ItdNotFoundError;
+exports.ItdRateLimitError = require_errors.ItdRateLimitError;
+exports.ItdRealtime = require_websocket.ItdRealtime;
+exports.ItdRealtimeClient = ItdRealtimeClient;
+exports.ItdServerError = require_errors.ItdServerError;
+exports.ItdStateError = require_errors.ItdStateError;
+exports.ItdTimeoutError = require_errors.ItdTimeoutError;
+exports.ItdValidationError = require_errors.ItdValidationError;
+exports.LIBRARY_VERSION = require_url.LIBRARY_VERSION;
+exports.NotificationType = require_url.NotificationType;
+exports.RealtimeComposer = require_websocket.RealtimeComposer;
+exports.RealtimeRouter = require_websocket.RealtimeRouter;
+exports.RealtimeStatus = require_url.RealtimeStatus;
+exports.RealtimeTransportKind = require_websocket.RealtimeTransportKind;
+exports.RealtimeUpdateOrigin = require_websocket.RealtimeUpdateOrigin;
+exports.RealtimeUpdateType = require_websocket.RealtimeUpdateType;
+exports.RuntimeMode = require_url.RuntimeMode;
+exports.UnauthorizedStreamError = require_websocket.UnauthorizedStreamError;
+exports.WebSocketTransport = require_websocket.WebSocketTransport;
+exports.anonymousAuth = require_auth_provider.anonymousAuth;
+exports.bearerToken = require_auth_provider.bearerToken;
+exports.canonicalNotificationType = require_url.canonicalNotificationType;
+exports.createRealtimeClient = createRealtimeClient;
+exports.formatNotificationText = require_url.formatNotificationText;
+exports.isItdApiError = require_errors.isItdApiError;
+exports.isItdAuthError = require_errors.isItdAuthError;
+exports.isItdError = require_errors.isItdError;
+exports.isItdRateLimitError = require_errors.isItdRateLimitError;
+exports.isItdStateError = require_errors.isItdStateError;
+exports.isKnownNotificationType = require_url.isKnownNotificationType;
+exports.normalizeNotification = require_url.normalizeNotification;
+exports.resolveNotificationUrl = require_url.resolveNotificationUrl;
+exports.runRealtimeMiddleware = require_websocket.runRealtimeMiddleware;
+exports.systemClock = require_url.systemClock;
+exports.tokenProvider = require_auth_provider.tokenProvider;
+
+//# sourceMappingURL=index.cjs.map

package/dist/realtime/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ItdRealtime","#runtime","createClientRuntime","ITD_CATALOG","#disposed","ItdStateError","#disposePromise","#dispose","anonymousAuth","bearerToken","pickNumber"],"sources":["../../src/realtime/client.ts"],"sourcesContent":["import { installAsyncDisposeFallback } from '../core/async-dispose.js';\nimport { type AuthProvider, anonymousAuth, bearerToken } from '../core/auth-provider.js';\nimport { ItdStateError } from '../core/errors.js';\nimport { type ClientRuntime, createClientRuntime } from '../core/execution/client-runtime.js';\nimport type { RuntimeOptions } from '../core/options.js';\nimport { pickNumber } from '../core/unwrap.js';\nimport { ITD_CATALOG } from '../domain/catalog.js';\nimport {\n  ItdRealtime,\n  type RealtimeDeps,\n  type RealtimeOptions,\n  setRealtimeConnectGuard,\n} from './stream.js';\nimport type { RealtimeContext } from './updates.js';\n\n/** Опции конструктора {@link ItdRealtimeClient}. */\nexport interface RealtimeClientOptions<C extends RealtimeContext = RealtimeContext>\n  extends RuntimeOptions,\n    RealtimeOptions<C> {\n  /**\n   * Авторизация. Строка — сокращение для {@link bearerToken}.\n   *\n   * Без неё поток идёт анонимно. Токен считается готовым: продлевать его клиент не умеет,\n   * а на отказ авторизации переподключение спрашивает токен заново. Сессия, которая входит\n   * по паролю и продлевает себя сама, живёт в полном `ItdClient`.\n   */\n  auth?: string | AuthProvider | undefined;\n}\n\n/**\n * Поток уведомлений с собственным конвейером запросов.\n *\n * Тот же {@link ItdRealtime}, что отдаёт `itd.realtime()`, но собранный без полного клиента:\n * ресурсы, билдеры и сессия сюда не входят. Нужен приложениям, которым от API нужны только\n * события, — виджетам, счётчикам непрочитанного, фоновым слушателям.\n *\n * @example\n * ```ts\n * import { createRealtimeClient } from 'itd-api/realtime';\n *\n * await using stream = createRealtimeClient({ auth: token });\n * stream.on('notification', ({ notification }) => console.log(notification.type));\n * await stream.connect();\n * ```\n */\nexport class ItdRealtimeClient<C extends RealtimeContext = RealtimeContext> extends ItdRealtime<C> {\n  readonly #runtime: ClientRuntime;\n  /** Общий результат терминальной очистки для идемпотентных повторных вызовов. */\n  #disposePromise: Promise<void> | undefined;\n  #disposed = false;\n\n  constructor(options: RealtimeClientOptions<C> = {}) {\n    const runtime = createClientRuntime(options, {\n      catalog: ITD_CATALOG,\n      auth: () => resolveAuthProvider(options.auth),\n    });\n\n    super(realtimeDeps(runtime), options);\n    this.#runtime = runtime;\n\n    setRealtimeConnectGuard<C>(this, () => {\n      if (!this.#disposed) return;\n      throw new ItdStateError(\n        'Поток уже окончательно освобождён через dispose(); нельзя подключить его снова. ' +\n          'Создайте новый',\n      );\n    });\n  }\n\n  /**\n   * Окончательно освобождает поток и его конвейер: отключает соединение, дожидается\n   * обработчиков и останавливает очередь запросов.\n   *\n   * Повторные вызовы возвращают тот же результат очистки.\n   */\n  dispose(): Promise<void> {\n    if (this.#disposePromise) return this.#disposePromise;\n    this.#disposed = true;\n    this.#disposePromise = this.#dispose();\n    return this.#disposePromise;\n  }\n\n  async #dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    this.disconnect();\n    try {\n      await this.drain();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      this.#runtime.close();\n      await this.#runtime.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    if (errors.length > 0) throw new AggregateError(errors, 'Не удалось освободить поток');\n  }\n\n  /** Позволяет использовать поток с `await using`. */\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n\n  static {\n    installAsyncDisposeFallback(ItdRealtimeClient);\n  }\n}\n\n/** Приводит опцию `auth` к провайдеру конвейера. */\nfunction resolveAuthProvider(auth: RealtimeClientOptions['auth']): AuthProvider {\n  if (auth === undefined) return anonymousAuth();\n  return typeof auth === 'string' ? bearerToken(auth) : auth;\n}\n\n/**\n * Связывает поток с собранным конвейером.\n *\n * Начальный счётчик непрочитанных берётся той же операцией, что и при опросе\n * (`realtime.poll.unread`): ресурс уведомлений потоку для этого не нужен.\n */\nfunction realtimeDeps(runtime: ClientRuntime): RealtimeDeps {\n  const request: NonNullable<RealtimeDeps['request']> = ({ operationId, path, query, signal }) =>\n    runtime.http.operation(operationId, { path, query, signal });\n\n  return {\n    baseUrl: runtime.config.baseUrl,\n    fetch: runtime.config.fetch,\n    clock: runtime.config.clock,\n    logger: runtime.config.logger,\n    request,\n    baseHeaders: (url) => runtime.platformHeaders(url),\n    getToken: () => runtime.auth.token(),\n    refresh: () => runtime.auth.recover(),\n    fetchUnreadCount: async () => {\n      const payload = await request({\n        operationId: 'realtime.poll.unread',\n        path: '/api/notifications/count',\n      });\n      return pickNumber(payload, 'count', 0);\n    },\n  };\n}\n\n/**\n * Создаёт поток уведомлений с собственным конвейером. Равнозначно конструктору\n * {@link ItdRealtimeClient}.\n */\nexport function createRealtimeClient<C extends RealtimeContext = RealtimeContext>(\n  options: RealtimeClientOptions<C> = {},\n): ItdRealtimeClient<C> {\n  return new ItdRealtimeClient<C>(options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,oBAAb,MAAa,0BAAuEA,kBAAAA,YAAe;CACjG;;CAEA;CACA,YAAY;CAEZ,YAAY,UAAoC,CAAC,GAAG;EAClD,MAAM,UAAUE,YAAAA,oBAAoB,SAAS;GAC3C,SAASC,YAAAA;GACT,YAAY,oBAAoB,QAAQ,IAAI;EAC9C,CAAC;EAED,MAAM,aAAa,OAAO,GAAG,OAAO;EACpC,KAAKF,WAAW;EAEhB,kBAAA,wBAA2B,YAAY;GACrC,IAAI,CAAC,KAAKG,WAAW;GACrB,MAAM,IAAIC,eAAAA,cACR,gGAEF;EACF,CAAC;CACH;;;;;;;CAQA,UAAyB;EACvB,IAAI,KAAKC,iBAAiB,OAAO,KAAKA;EACtC,KAAKF,YAAY;EACjB,KAAKE,kBAAkB,KAAKC,SAAS;EACrC,OAAO,KAAKD;CACd;CAEA,MAAMC,WAA0B;EAC9B,MAAM,SAAoB,CAAC;EAC3B,KAAK,WAAW;EAChB,IAAI;GACF,MAAM,KAAK,MAAM;EACnB,SAAS,OAAO;GACd,OAAO,KAAK,KAAK;EACnB;EACA,IAAI;GACF,KAAKN,SAAS,MAAM;GACpB,MAAM,KAAKA,SAAS,QAAQ;EAC9B,SAAS,OAAO;GACd,OAAO,KAAK,KAAK;EACnB;EACA,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,eAAe,QAAQ,6BAA6B;CACvF;;CAGA,CAAC,OAAO,gBAA+B;EACrC,OAAO,KAAK,QAAQ;CACtB;CAEA;EACE,YAAA,4BAA4B,iBAAiB;CAC/C;AACF;;AAGA,SAAS,oBAAoB,MAAmD;CAC9E,IAAI,SAAS,KAAA,GAAW,OAAOO,sBAAAA,cAAc;CAC7C,OAAO,OAAO,SAAS,WAAWC,sBAAAA,YAAY,IAAI,IAAI;AACxD;;;;;;;AAQA,SAAS,aAAa,SAAsC;CAC1D,MAAM,WAAiD,EAAE,aAAa,MAAM,OAAO,aACjF,QAAQ,KAAK,UAAU,aAAa;EAAE;EAAM;EAAO;CAAO,CAAC;CAE7D,OAAO;EACL,SAAS,QAAQ,OAAO;EACxB,OAAO,QAAQ,OAAO;EACtB,OAAO,QAAQ,OAAO;EACtB,QAAQ,QAAQ,OAAO;EACvB;EACA,cAAc,QAAQ,QAAQ,gBAAgB,GAAG;EACjD,gBAAgB,QAAQ,KAAK,MAAM;EACnC,eAAe,QAAQ,KAAK,QAAQ;EACpC,kBAAkB,YAAY;GAC5B,MAAM,UAAU,MAAM,QAAQ;IAC5B,aAAa;IACb,MAAM;GACR,CAAC;GACD,OAAOC,YAAAA,WAAW,SAAS,SAAS,CAAC;EACvC;CACF;AACF;;;;;AAMA,SAAgB,qBACd,UAAoC,CAAC,GACf;CACtB,OAAO,IAAI,kBAAqB,OAAO;AACzC"}

package/dist/realtime/index.d.cts

@@ -0,0 +1,51 @@
+import { B as Notification, C as ItdStateError, D as isItdAuthError, E as isItdApiError, Ft as Logger, I as isItdStateError, Mt as Unsubscribe, Nt as ClientHooks, P as isItdRateLimitError, R as NotificationEvent, S as ItdServerError, St as RealtimeStatus, T as ItdValidationError, V as NotificationSettings, Yt as RuntimeOptions, _ as ItdForbiddenError, a as ItdAbortError, at as DEFAULT_BASE_URL, bt as Loose, c as ItdApiErrorKind, en as RuntimeMode, et as AuthIdentity, f as ItdError, i as formatNotificationText, it as tokenProvider, jt as Listener, k as isItdError, l as ItdAuthError, n as canonicalNotificationType, nn as systemClock, nt as anonymousAuth, o as ItdApiError, p as ItdErrorKind, r as isKnownNotificationType, rt as bearerToken, st as LIBRARY_VERSION, t as resolveNotificationUrl, tn as ItdClock, tt as AuthProvider, u as ItdConfigError, v as ItdNetworkError, w as ItdTimeoutError, x as ItdRateLimitError, xt as NotificationType, y as ItdNotFoundError, z as normalizeNotification } from "../shared/url-B6-bXHKt.cjs";
+import { A as NotificationOfType, B as RealtimeUpdateOfType, C as RealtimeMiddlewareObj, D as RealtimeTypeGuard, E as RealtimeSequentializer, F as RealtimeNotificationSelector, G as RealtimeTransport, H as RealtimeUpdateType, I as RealtimeNotificationUpdate, J as UnauthorizedStreamError, K as TransportContext, L as RealtimeUnknownUpdate, M as RealtimeContextBase, N as RealtimeNotificationContext, O as runRealtimeMiddleware, P as RealtimeNotificationFilter, R as RealtimeUnreadCountUpdate, S as RealtimeMiddleware, T as RealtimePredicate, U as RealtimeRequest, V as RealtimeUpdateOrigin, W as RealtimeRequestInput, _ as RealtimeOptions, a as WebSocketTransportOptions, b as ReconnectOptions, c as RealtimeErrorContext, d as RealtimeMiddlewareLike, f as RealtimeRouteTable, g as RealtimeEvents, h as ItdRealtime, i as WebSocketTransport, j as RealtimeContext, k as NotificationEventOfType, l as RealtimeFilter, m as RealtimeRouter, n as WebSocketLike, o as RealtimeComposer, p as RealtimeRouteSelector, q as TransportEvent, r as WebSocketOpenFailureClassifier, s as RealtimeErrorBoundary, t as WebSocketImplementationOptions, u as RealtimeMiddlewareGroup, v as RealtimeTransportKind, w as RealtimeNext, x as RealtimeHandler, y as RealtimeEngineEvents, z as RealtimeUpdate } from "../shared/websocket-D1p32SB2.cjs";
+//#region src/realtime/client.d.ts
+/** Опции конструктора {@link ItdRealtimeClient}. */
+interface RealtimeClientOptions<C extends RealtimeContext = RealtimeContext> extends RuntimeOptions, RealtimeOptions<C> {
+  /**
+   * Авторизация. Строка — сокращение для {@link bearerToken}.
+   *
+   * Без неё поток идёт анонимно. Токен считается готовым: продлевать его клиент не умеет,
+   * а на отказ авторизации переподключение спрашивает токен заново. Сессия, которая входит
+   * по паролю и продлевает себя сама, живёт в полном `ItdClient`.
+   */
+  auth?: string | AuthProvider | undefined;
+}
+/**
+ * Поток уведомлений с собственным конвейером запросов.
+ *
+ * Тот же {@link ItdRealtime}, что отдаёт `itd.realtime()`, но собранный без полного клиента:
+ * ресурсы, билдеры и сессия сюда не входят. Нужен приложениям, которым от API нужны только
+ * события, — виджетам, счётчикам непрочитанного, фоновым слушателям.
+ *
+ * @example
+ * ```ts
+ * import { createRealtimeClient } from 'itd-api/realtime';
+ *
+ * await using stream = createRealtimeClient({ auth: token });
+ * stream.on('notification', ({ notification }) => console.log(notification.type));
+ * await stream.connect();
+ * ```
+ */
+declare class ItdRealtimeClient<C extends RealtimeContext = RealtimeContext> extends ItdRealtime<C> {
+  #private;
+  constructor(options?: RealtimeClientOptions<C>);
+  /**
+   * Окончательно освобождает поток и его конвейер: отключает соединение, дожидается
+   * обработчиков и останавливает очередь запросов.
+   *
+   * Повторные вызовы возвращают тот же результат очистки.
+   */
+  dispose(): Promise<void>;
+  /** Позволяет использовать поток с `await using`. */
+  [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Создаёт поток уведомлений с собственным конвейером. Равнозначно конструктору
+ * {@link ItdRealtimeClient}.
+ */
+declare function createRealtimeClient<C extends RealtimeContext = RealtimeContext>(options?: RealtimeClientOptions<C>): ItdRealtimeClient<C>;
+//#endregion
+export { type AuthIdentity, type AuthProvider, type ClientHooks, DEFAULT_BASE_URL, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, type ItdClock, ItdConfigError, ItdError, ItdErrorKind, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdRateLimitError, ItdRealtime, ItdRealtimeClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type Listener, type Logger, type Loose, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationOfType, type NotificationSettings, NotificationType, type RealtimeClientOptions, RealtimeComposer, type RealtimeContext, type RealtimeContextBase, type RealtimeEngineEvents, type RealtimeErrorBoundary, type RealtimeErrorContext, type RealtimeEvents, type RealtimeFilter, type RealtimeHandler, type RealtimeMiddleware, type RealtimeMiddlewareGroup, type RealtimeMiddlewareLike, type RealtimeMiddlewareObj, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRequest, type RealtimeRequestInput, type RealtimeRouteSelector, type RealtimeRouteTable, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, RuntimeMode, type RuntimeOptions, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, anonymousAuth, bearerToken, canonicalNotificationType, createRealtimeClient, formatNotificationText, isItdApiError, isItdAuthError, isItdError, isItdRateLimitError, isItdStateError, isKnownNotificationType, normalizeNotification, resolveNotificationUrl, runRealtimeMiddleware, systemClock, tokenProvider };
+//# sourceMappingURL=index.d.cts.map

package/dist/realtime/index.d.ts

@@ -0,0 +1,51 @@
+import { B as Notification, C as ItdStateError, D as isItdAuthError, E as isItdApiError, Ft as Logger, I as isItdStateError, Mt as Unsubscribe, Nt as ClientHooks, P as isItdRateLimitError, R as NotificationEvent, S as ItdServerError, St as RealtimeStatus, T as ItdValidationError, V as NotificationSettings, Yt as RuntimeOptions, _ as ItdForbiddenError, a as ItdAbortError, at as DEFAULT_BASE_URL, bt as Loose, c as ItdApiErrorKind, en as RuntimeMode, et as AuthIdentity, f as ItdError, i as formatNotificationText, it as tokenProvider, jt as Listener, k as isItdError, l as ItdAuthError, n as canonicalNotificationType, nn as systemClock, nt as anonymousAuth, o as ItdApiError, p as ItdErrorKind, r as isKnownNotificationType, rt as bearerToken, st as LIBRARY_VERSION, t as resolveNotificationUrl, tn as ItdClock, tt as AuthProvider, u as ItdConfigError, v as ItdNetworkError, w as ItdTimeoutError, x as ItdRateLimitError, xt as NotificationType, y as ItdNotFoundError, z as normalizeNotification } from "../shared/url-B6-bXHKt.js";
+import { A as NotificationOfType, B as RealtimeUpdateOfType, C as RealtimeMiddlewareObj, D as RealtimeTypeGuard, E as RealtimeSequentializer, F as RealtimeNotificationSelector, G as RealtimeTransport, H as RealtimeUpdateType, I as RealtimeNotificationUpdate, J as UnauthorizedStreamError, K as TransportContext, L as RealtimeUnknownUpdate, M as RealtimeContextBase, N as RealtimeNotificationContext, O as runRealtimeMiddleware, P as RealtimeNotificationFilter, R as RealtimeUnreadCountUpdate, S as RealtimeMiddleware, T as RealtimePredicate, U as RealtimeRequest, V as RealtimeUpdateOrigin, W as RealtimeRequestInput, _ as RealtimeOptions, a as WebSocketTransportOptions, b as ReconnectOptions, c as RealtimeErrorContext, d as RealtimeMiddlewareLike, f as RealtimeRouteTable, g as RealtimeEvents, h as ItdRealtime, i as WebSocketTransport, j as RealtimeContext, k as NotificationEventOfType, l as RealtimeFilter, m as RealtimeRouter, n as WebSocketLike, o as RealtimeComposer, p as RealtimeRouteSelector, q as TransportEvent, r as WebSocketOpenFailureClassifier, s as RealtimeErrorBoundary, t as WebSocketImplementationOptions, u as RealtimeMiddlewareGroup, v as RealtimeTransportKind, w as RealtimeNext, x as RealtimeHandler, y as RealtimeEngineEvents, z as RealtimeUpdate } from "../shared/websocket-BMtihD56.js";
+//#region src/realtime/client.d.ts
+/** Опции конструктора {@link ItdRealtimeClient}. */
+interface RealtimeClientOptions<C extends RealtimeContext = RealtimeContext> extends RuntimeOptions, RealtimeOptions<C> {
+  /**
+   * Авторизация. Строка — сокращение для {@link bearerToken}.
+   *
+   * Без неё поток идёт анонимно. Токен считается готовым: продлевать его клиент не умеет,
+   * а на отказ авторизации переподключение спрашивает токен заново. Сессия, которая входит
+   * по паролю и продлевает себя сама, живёт в полном `ItdClient`.
+   */
+  auth?: string | AuthProvider | undefined;
+}
+/**
+ * Поток уведомлений с собственным конвейером запросов.
+ *
+ * Тот же {@link ItdRealtime}, что отдаёт `itd.realtime()`, но собранный без полного клиента:
+ * ресурсы, билдеры и сессия сюда не входят. Нужен приложениям, которым от API нужны только
+ * события, — виджетам, счётчикам непрочитанного, фоновым слушателям.
+ *
+ * @example
+ * ```ts
+ * import { createRealtimeClient } from 'itd-api/realtime';
+ *
+ * await using stream = createRealtimeClient({ auth: token });
+ * stream.on('notification', ({ notification }) => console.log(notification.type));
+ * await stream.connect();
+ * ```
+ */
+declare class ItdRealtimeClient<C extends RealtimeContext = RealtimeContext> extends ItdRealtime<C> {
+  #private;
+  constructor(options?: RealtimeClientOptions<C>);
+  /**
+   * Окончательно освобождает поток и его конвейер: отключает соединение, дожидается
+   * обработчиков и останавливает очередь запросов.
+   *
+   * Повторные вызовы возвращают тот же результат очистки.
+   */
+  dispose(): Promise<void>;
+  /** Позволяет использовать поток с `await using`. */
+  [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Создаёт поток уведомлений с собственным конвейером. Равнозначно конструктору
+ * {@link ItdRealtimeClient}.
+ */
+declare function createRealtimeClient<C extends RealtimeContext = RealtimeContext>(options?: RealtimeClientOptions<C>): ItdRealtimeClient<C>;
+//#endregion
+export { type AuthIdentity, type AuthProvider, type ClientHooks, DEFAULT_BASE_URL, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, type ItdClock, ItdConfigError, ItdError, ItdErrorKind, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdRateLimitError, ItdRealtime, ItdRealtimeClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type Listener, type Logger, type Loose, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationOfType, type NotificationSettings, NotificationType, type RealtimeClientOptions, RealtimeComposer, type RealtimeContext, type RealtimeContextBase, type RealtimeEngineEvents, type RealtimeErrorBoundary, type RealtimeErrorContext, type RealtimeEvents, type RealtimeFilter, type RealtimeHandler, type RealtimeMiddleware, type RealtimeMiddlewareGroup, type RealtimeMiddlewareLike, type RealtimeMiddlewareObj, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRequest, type RealtimeRequestInput, type RealtimeRouteSelector, type RealtimeRouteTable, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, RuntimeMode, type RuntimeOptions, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, anonymousAuth, bearerToken, canonicalNotificationType, createRealtimeClient, formatNotificationText, isItdApiError, isItdAuthError, isItdError, isItdRateLimitError, isItdStateError, isKnownNotificationType, normalizeNotification, resolveNotificationUrl, runRealtimeMiddleware, systemClock, tokenProvider };
+//# sourceMappingURL=index.d.ts.map