itd-api 0.1.0 → 0.3.0

package/dist/node.js

@@ -1,140 +1,237 @@
-import { copySession, createRecordMultiStorage, ItdConfigError, ItdClient, ItdAccounts } from './chunk-6FB4HTKH.js';
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AUTH_FLAG_COOKIE, AUTH_PATHS, AccessType, AttachmentType, BUILT_IN_SERVICES, CommentSort, DEFAULT_BASE_URL, DEFAULT_STATUS_BASE_URL, DEFAULT_TIMEOUT, DEFAULT_UPLOAD_TIMEOUT, DEFAULT_USER_AGENT, DEVICE_ID_HEADER, DetectedRuntime, FeedTab, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, LocalStorageTokenStorage, MAX_RECONNECT_ATTEMPTS, MemoryMultiTokenStorage, MemoryTokenStorage, NOTIFICATION_TYPE_ALIASES, NotificationType, OAuthProvider, PaginationMode, Paginator, RECONNECT_BACKOFF, RECONNECT_JITTER, REFRESH_COOKIE, REFRESH_COOKIE_PATH, REQUEST_OPTION_KEYS, RealtimeStatus, RealtimeTransportKind, ReportReason, ReportTargetType, RuntimeMode, STATUS_SERVICE, STREAM_PATH, ServiceRegistry, ServiceState, SignInStatus, SpanType, TURNSTILE_SITE_KEY, UnauthorizedStreamError, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, autoSpans, canonicalNotificationType, comment, createMultiTokenStorage, createRecordMultiStorage, createTokenStorage, formatNotificationText, isBuilder, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, poll, post, readNotificationEvent, readUnreadCountEvent, renderSpans, report, resolveNotificationUrl, scopedTokenStorage, statusDays, toDate, utcStampToIso } from './chunk-6FB4HTKH.js';
-
-// src/node.ts
+import { _ as resolveFileStreamOptions, i as createRecordMultiStorage, l as FileTransferMode, u as boundedFileStream } from "./multi-storage-CyMe404l.js";
+import { c as ItdConfigError, f as ItdFileError, n as copySession, p as ItdFileErrorReason } from "./storage-D9tfHx7Z.js";
+//#region src/node.ts
+/**
+* `itd-api/node` — файловая система для Node, Bun и Deno.
+*
+* Здесь лежит только то, что требует `node:fs` и потому не может попасть в основной бандл:
+* иначе браузерные сборщики пытались бы разрешить этот модуль. Клиент, аккаунты, билдеры,
+* типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.
+*
+* @example
+* ```ts
+* import { ItdClient } from 'itd-api';
+* import { FileTokenStorage, fromPath } from 'itd-api/node';
+*
+* // Когда сессия уже сохранена, `auth` не нужен — токен возьмётся из хранилища.
+* const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });
+*
+* await itd.posts.create((p) => p.content('привет').attach(fromPath('./photo.jpg')));
+* ```
+*
+* @packageDocumentation
+*/
+/** Проверяет код системной ошибки без привязки к типам конкретного рантайма. */
 function hasErrorCode(error, code) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === code;
+	return typeof error === "object" && error !== null && "code" in error && error.code === code;
 }
-var nodeFileReader = async (path) => {
-  const { readFile } = await import('fs/promises');
-  const { basename } = await import('path');
-  return { data: new Uint8Array(await readFile(path)), filename: basename(path) };
-};
+function fromPath(path, options = {}) {
+	const resolved = resolveFileStreamOptions(options);
+	if (resolved.mode === FileTransferMode.Stream) return { open: async ({ signal }) => {
+		const [{ createReadStream }, { stat }, { basename }, { Readable }] = await Promise.all([
+			import("node:fs"),
+			import("node:fs/promises"),
+			import("node:path"),
+			import("node:stream")
+		]);
+		const info = await stat(path);
+		if (resolved.maxBytes !== void 0 && info.size > resolved.maxBytes) throw new ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`, {
+			reason: ItdFileErrorReason.TooLarge,
+			limit: resolved.maxBytes,
+			actual: info.size
+		});
+		const file = createReadStream(path, {
+			highWaterMark: Math.min(resolved.streamBufferBytes, 1024 * 1024),
+			...signal ? { signal } : {}
+		});
+		return {
+			stream: boundedFileStream(Readable.toWeb(file), {
+				...resolved.maxBytes !== void 0 ? { maxBytes: resolved.maxBytes } : {},
+				streamBufferBytes: resolved.streamBufferBytes,
+				...signal ? { signal } : {}
+			}),
+			filename: options.filename ?? basename(path),
+			...options.contentType ? { contentType: options.contentType } : {},
+			size: info.size,
+			close: () => {
+				file.destroy();
+			}
+		};
+	} };
+	return { load: async ({ signal }) => {
+		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 ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${info.size}`, {
+				reason: 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 ItdFileError(`файл ${path} больше предела в ${resolved.maxBytes} байт: ${file.byteLength}`, {
+			reason: ItdFileErrorReason.TooLarge,
+			limit: resolved.maxBytes,
+			actual: file.byteLength
+		});
+		return {
+			file,
+			filename: options.filename ?? basename(path),
+			...options.contentType ? { contentType: options.contentType } : {}
+		};
+	} };
+}
+/**
+* Читает и разбирает JSON-файл.
+*
+* Отсутствующий файл означает `null`. Остальные ошибки файловой системы не скрываются.
+* Одиночное хранилище ради обратной совместимости считает повреждённый JSON пустым,
+* а мультихранилище требует строгого разбора: молча затереть файл с несколькими токенами
+* особенно опасно.
+*/
 async function readJsonFile(path, strict = false) {
-  let raw;
-  try {
-    const { readFile } = await import('fs/promises');
-    raw = await readFile(path, "utf8");
-  } catch (error) {
-    if (hasErrorCode(error, "ENOENT")) return null;
-    throw error;
-  }
-  try {
-    return JSON.parse(raw);
-  } catch {
-    if (!strict) return null;
-    throw new ItdConfigError(
-      `\u0424\u0430\u0439\u043B ${path} \u043F\u043E\u0432\u0440\u0435\u0436\u0434\u0451\u043D: \u043E\u0436\u0438\u0434\u0430\u043B\u0441\u044F JSON \u0441 \u0441\u0435\u0441\u0441\u0438\u044F\u043C\u0438 \u0430\u043A\u043A\u0430\u0443\u043D\u0442\u043E\u0432. \u0418\u0441\u043F\u0440\u0430\u0432\u044C\u0442\u0435 \u0444\u0430\u0439\u043B \u0438\u043B\u0438 \u043F\u0435\u0440\u0435\u043D\u0435\u0441\u0438\u0442\u0435 \u0435\u0433\u043E \u043F\u0435\u0440\u0435\u0434 \u0441\u043B\u0435\u0434\u0443\u044E\u0449\u0438\u043C \u0441\u043E\u0445\u0440\u0430\u043D\u0435\u043D\u0438\u0435\u043C.`
-    );
-  }
+	let raw;
+	try {
+		const { readFile } = await import("node:fs/promises");
+		raw = await readFile(path, "utf8");
+	} catch (error) {
+		if (hasErrorCode(error, "ENOENT")) return null;
+		throw error;
+	}
+	try {
+		return JSON.parse(raw);
+	} catch {
+		if (!strict) return null;
+		throw new ItdConfigError(`Файл ${path} повреждён: ожидался JSON с сессиями аккаунтов. Исправьте файл или перенесите его перед следующим сохранением.`);
+	}
 }
+/**
+* Записывает JSON во временный файл и переименовывает его поверх целевого.
+*
+* Права `0600` (чтение и запись только владельцу) — в файле лежат токены. Переименование
+* атомарно, поэтому падение процесса посреди сохранения не оставит повреждённого файла.
+*/
 async function writeJsonAtomic(path, value) {
-  const { writeFile, rename, unlink } = await import('fs/promises');
-  const pid = typeof process !== "undefined" ? process.pid : 0;
-  const temporary = `${path}.${pid}.${Math.random().toString(36).slice(2)}.tmp`;
-  try {
-    await writeFile(temporary, JSON.stringify(value, null, 2), { encoding: "utf8", mode: 384 });
-    await rename(temporary, path);
-  } catch (error) {
-    await unlink(temporary).catch(() => {
-    });
-    throw error;
-  }
+	const { writeFile, rename, unlink } = await import("node:fs/promises");
+	const temporary = `${path}.${typeof process !== "undefined" ? process.pid : 0}.${Math.random().toString(36).slice(2)}.tmp`;
+	try {
+		await writeFile(temporary, JSON.stringify(value, null, 2), {
+			encoding: "utf8",
+			mode: 384
+		});
+		await rename(temporary, path);
+	} catch (error) {
+		await unlink(temporary).catch(() => {});
+		throw error;
+	}
 }
+/** Удаляет файл. Благодаря `force` отсутствие файла ошибкой не считается. */
 async function removeFile(path) {
-  const { rm } = await import('fs/promises');
-  await rm(path, { force: true });
+	const { rm } = await import("node:fs/promises");
+	await rm(path, { force: true });
 }
+/**
+* Хранит сессию в файле.
+*
+* Нужна долгоживущим процессам: без неё бот при каждом запуске входит заново — а вход
+* требует решённой капчи, да и серия входов подряд может привести к временной блокировке
+* аккаунта. С сохранённой сессией опция `auth` не нужна вовсе.
+*
+* Файл создаётся с правами `0600` (чтение и запись только владельцу) — в нём лежат токены.
+* Запись идёт через временный файл с последующим переименованием, поэтому падение процесса
+* посреди сохранения не оставит повреждённую сессию.
+*
+* @example
+* ```ts
+* const itd = new ItdClient({ storage: new FileTokenStorage('./.itd-session.json') });
+* ```
+*/
 var FileTokenStorage = class {
-  #path;
-  /**
-   * Цепочка операций с файлом. Запись и удаление выполняются последовательно
-   * в порядке вызова; ошибка одной операции не останавливает следующие.
-   */
-  #writing = Promise.resolve();
-  /** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
-  constructor(path) {
-    this.#path = path;
-  }
-  async get() {
-    await this.#writing.then(
-      () => void 0,
-      () => void 0
-    );
-    const parsed = await readJsonFile(this.#path);
-    return typeof parsed === "object" && parsed !== null ? copySession(parsed) : null;
-  }
-  set(session) {
-    const snapshot = copySession(session);
-    return this.#enqueue(() => writeJsonAtomic(this.#path, snapshot));
-  }
-  clear() {
-    return this.#enqueue(() => removeFile(this.#path));
-  }
-  /** Добавляет файловую операцию в очередь. */
-  #enqueue(operation) {
-    this.#writing = this.#writing.then(operation, operation);
-    return this.#writing;
-  }
+	#path;
+	/**
+	* Цепочка операций с файлом. Запись и удаление выполняются последовательно
+	* в порядке вызова; ошибка одной операции не останавливает следующие.
+	*/
+	#writing = Promise.resolve();
+	/** @param path путь к файлу сессии. Добавьте его в `.gitignore`. */
+	constructor(path) {
+		this.#path = path;
+	}
+	async get() {
+		await this.#writing.then(() => void 0, () => void 0);
+		const parsed = await readJsonFile(this.#path);
+		return typeof parsed === "object" && parsed !== null ? copySession(parsed) : null;
+	}
+	set(session) {
+		const snapshot = copySession(session);
+		return this.#enqueue(() => writeJsonAtomic(this.#path, snapshot));
+	}
+	clear() {
+		return this.#enqueue(() => removeFile(this.#path));
+	}
+	/** Добавляет файловую операцию в очередь. */
+	#enqueue(operation) {
+		this.#writing = this.#writing.then(operation, operation);
+		return this.#writing;
+	}
 };
-var SESSIONS_FILE_VERSION = 1;
+/** Версия формата файла с сессиями нескольких аккаунтов. */
+const SESSIONS_FILE_VERSION = 1;
+/**
+* Хранит сессии нескольких аккаунтов в одном файле.
+*
+* Разбирается с гонкой «прочитать, изменить, записать»: десять аккаунтов пишут в один файл,
+* и без общего слепка с очередью записей они теряли бы сессии друг друга. Как и
+* {@link FileTokenStorage}, пишет через временный файл с правами `0600`.
+*
+* Формат — конверт `{ version, accounts }`, а не голая карта: так файл нескольких аккаунтов
+* не спутать с однопользовательским, и чужой не будет молча перезаписан.
+*
+* @example
+* ```ts
+* const accounts = new ItdAccounts({
+*   storage: new FileMultiTokenStorage('./.itd-sessions.json'),
+* });
+* await accounts.restore();
+* ```
+*/
 var FileMultiTokenStorage = class {
-  #path;
-  #inner;
-  /** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
-  constructor(path) {
-    this.#path = path;
-    this.#inner = createRecordMultiStorage({
-      read: () => this.#read(),
-      write: (accounts) => writeJsonAtomic(path, { version: SESSIONS_FILE_VERSION, accounts }),
-      // Последний аккаунт ушёл — файл с пустой картой выглядел бы мусором.
-      remove: () => removeFile(path)
-    });
-  }
-  get(account) {
-    return Promise.resolve(this.#inner.get(account));
-  }
-  set(account, session) {
-    return Promise.resolve(this.#inner.set(account, session));
-  }
-  clear(account) {
-    return Promise.resolve(this.#inner.clear(account));
-  }
-  accounts() {
-    return Promise.resolve(this.#inner.accounts());
-  }
-  async #read() {
-    const parsed = await readJsonFile(this.#path, true);
-    if (parsed === null) return null;
-    const envelope = typeof parsed === "object" && parsed !== null ? parsed : void 0;
-    const accounts = envelope?.accounts;
-    if (envelope?.version !== SESSIONS_FILE_VERSION || typeof accounts !== "object" || accounts === null || Array.isArray(accounts)) {
-      throw new ItdConfigError(
-        `\u0424\u0430\u0439\u043B ${this.#path} \u0438\u043C\u0435\u0435\u0442 \u043D\u0435\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043C\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442: \u043E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F { version: ${SESSIONS_FILE_VERSION}, accounts }. \u0412\u043E\u0437\u043C\u043E\u0436\u043D\u043E, \u044D\u0442\u043E \u0444\u0430\u0439\u043B \u043E\u0434\u0438\u043D\u043E\u0447\u043D\u043E\u0439 \u0441\u0435\u0441\u0441\u0438\u0438 \u0438\u043B\u0438 \u0444\u0430\u0439\u043B \u0434\u0440\u0443\u0433\u043E\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u2014 \u0432\u043E\u0437\u044C\u043C\u0438\u0442\u0435 \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u044B\u0439 \u043F\u0443\u0442\u044C, \u0447\u0442\u043E\u0431\u044B \u043D\u0435 \u043F\u0435\u0440\u0435\u0437\u0430\u043F\u0438\u0441\u0430\u0442\u044C \u0435\u0433\u043E.`
-      );
-    }
-    return accounts;
-  }
-};
-var ItdClient2 = class extends ItdClient {
-  constructor(options = {}, internals = {}) {
-    super(options, { ...internals, fileReader: nodeFileReader });
-  }
+	#path;
+	#inner;
+	/** @param path путь к файлу сессий. Добавьте его в `.gitignore`. */
+	constructor(path) {
+		this.#path = path;
+		this.#inner = createRecordMultiStorage({
+			read: () => this.#read(),
+			write: (accounts) => writeJsonAtomic(path, {
+				version: SESSIONS_FILE_VERSION,
+				accounts
+			}),
+			remove: () => removeFile(path)
+		});
+	}
+	get(account) {
+		return Promise.resolve(this.#inner.get(account));
+	}
+	set(account, session) {
+		return Promise.resolve(this.#inner.set(account, session));
+	}
+	clear(account) {
+		return Promise.resolve(this.#inner.clear(account));
+	}
+	accounts() {
+		return Promise.resolve(this.#inner.accounts());
+	}
+	async #read() {
+		const parsed = await readJsonFile(this.#path, true);
+		if (parsed === null) return null;
+		const envelope = typeof parsed === "object" && parsed !== null ? parsed : void 0;
+		const accounts = envelope?.accounts;
+		if (envelope?.version !== SESSIONS_FILE_VERSION || typeof accounts !== "object" || accounts === null || Array.isArray(accounts)) throw new ItdConfigError(`Файл ${this.#path} имеет неподдерживаемый формат: ожидается { version: ${SESSIONS_FILE_VERSION}, accounts }. Возможно, это файл одиночной сессии или файл другой версии — возьмите отдельный путь, чтобы не перезаписать его.`);
+		return accounts;
+	}
 };
-function createClient(options = {}) {
-  return new ItdClient2(options);
-}
-var ItdAccounts2 = class extends ItdAccounts {
-  constructor(options = {}) {
-    super(options, {
-      createClient: (clientOptions, internals) => new ItdClient2(clientOptions, internals)
-    });
-  }
-};
-function createAccounts(options = {}) {
-  return new ItdAccounts2(options);
-}
+//#endregion
+export { FileMultiTokenStorage, FileTokenStorage, fromPath };
 
-export { FileMultiTokenStorage, FileTokenStorage, ItdAccounts2 as ItdAccounts, ItdClient2 as ItdClient, createAccounts, createClient, nodeFileReader };
-//# sourceMappingURL=node.js.map
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/runtime-CFEsf-jD.cjs

@@ -0,0 +1,185 @@
+const require_storage = require("./storage-ycBqLBRB.cjs");
+//#region src/core/runtime.ts
+/**
+* Как библиотека обращается с cookie.
+*
+* - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
+* - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
+* - `auto` — определяется по среде исполнения (значение по умолчанию).
+*/
+const RuntimeMode = Object.freeze({
+	/** Определяется по среде исполнения. Значение по умолчанию. */
+	Auto: "auto",
+	/** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
+	Browser: "browser",
+	/** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
+	Server: "server"
+});
+/** Распознанная среда исполнения. */
+const DetectedRuntime = Object.freeze({
+	Browser: "browser",
+	/** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
+	ReactNative: "react-native",
+	Server: "server"
+});
+/**
+* Определяет среду исполнения.
+*
+* React Native выделен отдельно намеренно: там есть `window`, но нет `document`, а cookie
+* хранит нативный сетевой слой (`NSHTTPCookieStorage` / `OkHttp`). Свой jar в этой среде
+* привёл бы к отправке cookie дважды.
+*/
+function detectRuntime() {
+	if (globalThis.navigator?.product === "ReactNative") return DetectedRuntime.ReactNative;
+	if (typeof document !== "undefined") return DetectedRuntime.Browser;
+	return DetectedRuntime.Server;
+}
+/**
+* Нужно ли вести собственный cookie-jar.
+*
+* Только в серверных средах: в браузере `Set-Cookie` из JS не читается и не нужен,
+* в React Native cookie ведёт нативный слой.
+*/
+function shouldUseCookieJar(mode) {
+	if (mode === RuntimeMode.Browser) return false;
+	if (mode === RuntimeMode.Server) return true;
+	return detectRuntime() === DetectedRuntime.Server;
+}
+/**
+* Нужно ли отправлять запросы с `credentials: 'include'`.
+*
+* Только в браузере: именно так refresh-cookie попадает в запрос `POST /api/v1/auth/refresh`.
+* Требует настроенного CORS на стороне итд.com — если его нет, укажите свой прокси в `baseUrl`.
+*/
+function shouldSendCredentials(mode) {
+	if (mode === RuntimeMode.Browser) return true;
+	if (mode === RuntimeMode.Server) return false;
+	return detectRuntime() === DetectedRuntime.Browser;
+}
+/**
+* Возвращает реализацию `fetch`.
+*
+* @param custom реализация из конфигурации клиента, если пользователь её передал
+* @throws {ItdConfigError} если `fetch` недоступен — например, на Node ниже 18
+*/
+function resolveFetch(custom) {
+	if (custom !== void 0) {
+		if (typeof custom !== "function") throw new require_storage.ItdConfigError("fetch должен быть функцией");
+		return custom;
+	}
+	if (typeof globalThis.fetch === "function") return globalThis.fetch.bind(globalThis);
+	throw new require_storage.ItdConfigError("В этой среде нет глобального fetch. Обновитесь до Node 18+ либо передайте свою реализацию через опцию fetch.");
+}
+/**
+* Проверки бинарных типов, безопасные в любой среде.
+*
+* Обычный `instanceof` здесь недостаточен: конструктора может не быть вовсе, и тогда
+* проверка падает с `ReferenceError`, а не возвращает `false`. `Blob` есть в Node с 18.0,
+* но `File` стал глобальным только в Node 20 — при заявленной поддержке Node 18 голый
+* `instanceof File` ронял бы любую загрузку.
+*/
+function isBlob(value) {
+	return typeof Blob !== "undefined" && value instanceof Blob;
+}
+/** @see {@link isBlob} */
+function isFile(value) {
+	return typeof File !== "undefined" && value instanceof File;
+}
+/** Доступно ли потоковое чтение тела ответа — от этого зависит, сработает ли SSE. */
+function supportsStreamingBody() {
+	return typeof ReadableStream !== "undefined" && typeof TextDecoder !== "undefined";
+}
+/**
+* Создаёт идентификатор устройства для заголовка `X-Device-Id` — UUID v4.
+*
+* `crypto.randomUUID` есть в Node 19+, браузерах и Deno, но отсутствует в Node 18 вне
+* защищённого контекста, поэтому предусмотрен запасной путь.
+*/
+function createDeviceId() {
+	const webCrypto = globalThis.crypto;
+	if (typeof webCrypto?.randomUUID === "function") return webCrypto.randomUUID();
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	if (typeof webCrypto?.getRandomValues === "function") webCrypto.getRandomValues(bytes);
+	else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
+	bytes[6] = bytes[6] & 15 | 64;
+	bytes[8] = bytes[8] & 63 | 128;
+	const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+	return [
+		hex.slice(0, 8),
+		hex.slice(8, 12),
+		hex.slice(12, 16),
+		hex.slice(16, 20),
+		hex.slice(20, 32)
+	].join("-");
+}
+/** Есть ли в среде `localStorage`. Проверка безопасна: доступ к нему может бросать. */
+function hasLocalStorage() {
+	try {
+		return typeof globalThis.localStorage !== "undefined" && globalThis.localStorage !== null;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+Object.defineProperty(exports, "DetectedRuntime", {
+	enumerable: true,
+	get: function() {
+		return DetectedRuntime;
+	}
+});
+Object.defineProperty(exports, "RuntimeMode", {
+	enumerable: true,
+	get: function() {
+		return RuntimeMode;
+	}
+});
+Object.defineProperty(exports, "createDeviceId", {
+	enumerable: true,
+	get: function() {
+		return createDeviceId;
+	}
+});
+Object.defineProperty(exports, "hasLocalStorage", {
+	enumerable: true,
+	get: function() {
+		return hasLocalStorage;
+	}
+});
+Object.defineProperty(exports, "isBlob", {
+	enumerable: true,
+	get: function() {
+		return isBlob;
+	}
+});
+Object.defineProperty(exports, "isFile", {
+	enumerable: true,
+	get: function() {
+		return isFile;
+	}
+});
+Object.defineProperty(exports, "resolveFetch", {
+	enumerable: true,
+	get: function() {
+		return resolveFetch;
+	}
+});
+Object.defineProperty(exports, "shouldSendCredentials", {
+	enumerable: true,
+	get: function() {
+		return shouldSendCredentials;
+	}
+});
+Object.defineProperty(exports, "shouldUseCookieJar", {
+	enumerable: true,
+	get: function() {
+		return shouldUseCookieJar;
+	}
+});
+Object.defineProperty(exports, "supportsStreamingBody", {
+	enumerable: true,
+	get: function() {
+		return supportsStreamingBody;
+	}
+});
+
+//# sourceMappingURL=runtime-CFEsf-jD.cjs.map