itd-api 0.7.1 → 0.8.0

package/dist/shared/{multi-storage--yTEqiod.cjs.map → multi-storage-CCUgkqvI.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"multi-storage--yTEqiod.cjs","names":["CookieJar","AUTH_FLAG_COOKIE","#store","MemoryKeyValueStore","copySession","ItdConfigError","createKeyValueStore","isEnumerableKeyValueStore","collectKeyValueStoreKeys"],"sources":["../../src/session/multi-storage.ts"],"sourcesContent":["import { AUTH_FLAG_COOKIE, CookieJar } from '../core/cookies.js';\nimport { ItdConfigError } from '../core/errors.js';\nimport {\n  collectKeyValueStoreKeys,\n  createKeyValueStore,\n  type EnumerableKeyValueStore,\n  isEnumerableKeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/key-value-store.js';\nimport { copySession, type ItdSession, type TokenStorage } from './storage.js';\n\n/**\n * Хранилище сессий нескольких аккаунтов.\n *\n * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:\n * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,\n * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:\n * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения\n * на длину ключа остаются за адаптером.\n *\n * Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Хранилище поверх enumerable Redis backend\n * ```ts\n * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport interface MultiTokenStorage {\n  /** Прочитать сессию аккаунта. `null`, если её нет. */\n  get(account: string): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию аккаунта целиком. */\n  set(account: string, session: ItdSession): void | Promise<void>;\n  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(account: string): void | Promise<void>;\n  /**\n   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов\n   * после перезапуска процесса.\n   *\n   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,\n   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.\n   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после\n   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.\n   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть\n   * доступны по имени.\n   */\n  accounts(): readonly string[] | Promise<readonly string[]>;\n}\n\n/**\n * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает\n * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.\n */\nexport function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage {\n  return {\n    get: () => storage.get(account),\n    set: (session) => storage.set(account, session),\n    clear: () => storage.clear(account),\n  };\n}\n\n/**\n * Можно ли восстановить авторизованный аккаунт из записи.\n *\n * Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет\n * выполнить ни одного авторизованного запроса.\n *\n * @internal\n */\nexport function isRestorableSession(session: ItdSession | null): session is ItdSession {\n  if (!session) return false;\n  if (session.accessToken || session.refreshToken) return true;\n\n  const jar = new CookieJar();\n  jar.deserialize(session.cookies);\n  return jar.has(AUTH_FLAG_COOKIE);\n}\n\n/**\n * Управляемый срез хранилища для клиента аккаунта.\n *\n * После `revoke()` новые записи не доходят до общего хранилища, а `drain()` позволяет\n * дождаться уже начатых. Так удалённый клиент или завершившийся с опозданием refresh\n * не воскресят сессию после `removeAccount(..., { forget: true })`.\n *\n * @internal\n */\nexport interface ControlledTokenStorage {\n  storage: TokenStorage;\n  revoke(): void;\n  drain(): Promise<void>;\n}\n\n/** @internal */\nexport function controlledTokenStorage(\n  storage: MultiTokenStorage,\n  account: string,\n): ControlledTokenStorage {\n  let revoked = false;\n  const pending = new Set<Promise<void>>();\n\n  const mutate = (operation: () => void | Promise<void>): Promise<void> => {\n    if (revoked) return Promise.resolve();\n\n    const promise = Promise.resolve().then(operation);\n    pending.add(promise);\n    void promise.then(\n      () => pending.delete(promise),\n      () => pending.delete(promise),\n    );\n    return promise;\n  };\n\n  return {\n    storage: {\n      get: () => (revoked ? null : storage.get(account)),\n      set: (session) => mutate(() => storage.set(account, session)),\n      clear: () => mutate(() => storage.clear(account)),\n    },\n    revoke() {\n      revoked = true;\n    },\n    async drain() {\n      await Promise.all([...pending]);\n    },\n  };\n}\n\n/**\n * Мультихранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`\n * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.\n */\nexport class MemoryMultiTokenStorage implements MultiTokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: Readonly<Record<string, ItdSession>> | null) {\n    for (const [account, session] of Object.entries(initial ?? {})) {\n      this.#store.set(accountKey(account), copySession(session));\n    }\n  }\n\n  get(account: string): ItdSession | null {\n    const session = this.#store.get(accountKey(account));\n    return session ? copySession(session) : null;\n  }\n\n  set(account: string, session: ItdSession): void {\n    this.#store.set(accountKey(account), copySession(session));\n  }\n\n  clear(account: string): void {\n    this.#store.delete(accountKey(account));\n  }\n\n  accounts(): string[] {\n    return this.#store\n      .keys(ACCOUNT_KEY_PREFIX)\n      .flatMap((key) => readAccountName(key.slice(ACCOUNT_KEY_PREFIX.length)) ?? []);\n  }\n}\n\nconst ACCOUNT_KEY_PREFIX = 'accounts/';\n\nfunction accountKey(account: string): string {\n  return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;\n}\n\n/** Читает имя аккаунта из ключа. `undefined` — ключ не декодируется и запись пропускается. */\nfunction readAccountName(encoded: string): string | undefined {\n  try {\n    return decodeURIComponent(encoded);\n  } catch {\n    console.warn(\n      `[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`,\n    );\n    return undefined;\n  }\n}\n\n/** Настройки доменного адаптера нескольких сессий. */\nexport interface MultiTokenStorageAdapterOptions {\n  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */\n  prefix?: string | undefined;\n}\n\n/**\n * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.\n *\n * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому\n * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.\n */\nexport function createMultiTokenStorage(\n  store: EnumerableKeyValueStore<ItdSession>,\n  options: MultiTokenStorageAdapterOptions = {},\n): MultiTokenStorage {\n  const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;\n  if (typeof prefix !== 'string') {\n    throw new ItdConfigError('prefix MultiTokenStorage должен быть строкой');\n  }\n  const backend = createKeyValueStore(store);\n  if (!isEnumerableKeyValueStore(backend)) {\n    throw new ItdConfigError('MultiTokenStorage требует KeyValueStore с методом keys()');\n  }\n  const key = (account: string) => `${prefix}${encodeURIComponent(account)}`;\n  return {\n    async get(account) {\n      const session = await backend.get(key(account));\n      return session ? copySession(session) : null;\n    },\n    set: (account, session) => backend.set(key(account), copySession(session)),\n    clear: (account) => backend.delete(key(account)),\n    async accounts() {\n      const keys = await collectKeyValueStoreKeys(backend, prefix);\n      return keys.flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"multi-storage-CCUgkqvI.cjs","names":["CookieJar","AUTH_FLAG_COOKIE","#store","MemoryKeyValueStore","copySession","ItdConfigError","createKeyValueStore","isEnumerableKeyValueStore","collectKeyValueStoreKeys"],"sources":["../../src/session/multi-storage.ts"],"sourcesContent":["import { AUTH_FLAG_COOKIE, CookieJar } from '../core/cookies.js';\nimport { ItdConfigError } from '../core/errors.js';\nimport {\n  collectKeyValueStoreKeys,\n  createKeyValueStore,\n  type EnumerableKeyValueStore,\n  isEnumerableKeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/key-value-store.js';\nimport { copySession, type ItdSession, type TokenStorage } from './storage.js';\n\n/**\n * Хранилище сессий нескольких аккаунтов.\n *\n * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:\n * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,\n * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:\n * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения\n * на длину ключа остаются за адаптером.\n *\n * Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Хранилище поверх enumerable Redis backend\n * ```ts\n * const storage = createMultiTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport interface MultiTokenStorage {\n  /** Прочитать сессию аккаунта. `null`, если её нет. */\n  get(account: string): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию аккаунта целиком. */\n  set(account: string, session: ItdSession): void | Promise<void>;\n  /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(account: string): void | Promise<void>;\n  /**\n   * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов\n   * после перезапуска процесса.\n   *\n   * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,\n   * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.\n   * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после\n   * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.\n   * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть\n   * доступны по имени.\n   */\n  accounts(): readonly string[] | Promise<readonly string[]>;\n}\n\n/**\n * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает\n * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.\n */\nexport function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage {\n  return {\n    get: () => storage.get(account),\n    set: (session) => storage.set(account, session),\n    clear: () => storage.clear(account),\n  };\n}\n\n/**\n * Можно ли восстановить авторизованный аккаунт из записи.\n *\n * Один `deviceId` не считается сессией: он намеренно переживает выход, но не позволяет\n * выполнить ни одного авторизованного запроса.\n *\n * @internal\n */\nexport function isRestorableSession(session: ItdSession | null): session is ItdSession {\n  if (!session) return false;\n  if (session.accessToken || session.refreshToken) return true;\n\n  const jar = new CookieJar();\n  jar.deserialize(session.cookies);\n  return jar.has(AUTH_FLAG_COOKIE);\n}\n\n/**\n * Управляемый срез хранилища для клиента аккаунта.\n *\n * После `revoke()` новые записи не доходят до общего хранилища, а `drain()` позволяет\n * дождаться уже начатых. Так удалённый клиент или завершившийся с опозданием refresh\n * не воскресят сессию после `removeAccount(..., { forget: true })`.\n *\n * @internal\n */\nexport interface ControlledTokenStorage {\n  storage: TokenStorage;\n  revoke(): void;\n  drain(): Promise<void>;\n}\n\n/** @internal */\nexport function controlledTokenStorage(\n  storage: MultiTokenStorage,\n  account: string,\n): ControlledTokenStorage {\n  let revoked = false;\n  const pending = new Set<Promise<void>>();\n\n  const mutate = (operation: () => void | Promise<void>): Promise<void> => {\n    if (revoked) return Promise.resolve();\n\n    const promise = Promise.resolve().then(operation);\n    pending.add(promise);\n    void promise.then(\n      () => pending.delete(promise),\n      () => pending.delete(promise),\n    );\n    return promise;\n  };\n\n  return {\n    storage: {\n      get: () => (revoked ? null : storage.get(account)),\n      set: (session) => mutate(() => storage.set(account, session)),\n      clear: () => mutate(() => storage.clear(account)),\n    },\n    revoke() {\n      revoked = true;\n    },\n    async drain() {\n      await Promise.all([...pending]);\n    },\n  };\n}\n\n/**\n * Мультихранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`\n * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.\n */\nexport class MemoryMultiTokenStorage implements MultiTokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: Readonly<Record<string, ItdSession>> | null) {\n    for (const [account, session] of Object.entries(initial ?? {})) {\n      this.#store.set(accountKey(account), copySession(session));\n    }\n  }\n\n  get(account: string): ItdSession | null {\n    const session = this.#store.get(accountKey(account));\n    return session ? copySession(session) : null;\n  }\n\n  set(account: string, session: ItdSession): void {\n    this.#store.set(accountKey(account), copySession(session));\n  }\n\n  clear(account: string): void {\n    this.#store.delete(accountKey(account));\n  }\n\n  accounts(): string[] {\n    return this.#store\n      .keys(ACCOUNT_KEY_PREFIX)\n      .flatMap((key) => readAccountName(key.slice(ACCOUNT_KEY_PREFIX.length)) ?? []);\n  }\n}\n\nconst ACCOUNT_KEY_PREFIX = 'accounts/';\n\nfunction accountKey(account: string): string {\n  return `${ACCOUNT_KEY_PREFIX}${encodeURIComponent(account)}`;\n}\n\n/** Читает имя аккаунта из ключа. `undefined` — ключ не декодируется и запись пропускается. */\nfunction readAccountName(encoded: string): string | undefined {\n  try {\n    return decodeURIComponent(encoded);\n  } catch {\n    console.warn(\n      `[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`,\n    );\n    return undefined;\n  }\n}\n\n/** Настройки доменного адаптера нескольких сессий. */\nexport interface MultiTokenStorageAdapterOptions {\n  /** Префикс ключей аккаунтов. По умолчанию `accounts/`. */\n  prefix?: string | undefined;\n}\n\n/**\n * Создаёт доменное хранилище нескольких сессий поверх enumerable key-value backend.\n *\n * Отдельный индекс аккаунтов не используется: `accounts()` перечисляет ключи backend. Поэтому\n * запись сессии не может разойтись с индексом, но backend обязан эффективно поддерживать `keys`.\n */\nexport function createMultiTokenStorage(\n  store: EnumerableKeyValueStore<ItdSession>,\n  options: MultiTokenStorageAdapterOptions = {},\n): MultiTokenStorage {\n  const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;\n  if (typeof prefix !== 'string') {\n    throw new ItdConfigError('prefix MultiTokenStorage должен быть строкой');\n  }\n  const backend = createKeyValueStore(store);\n  if (!isEnumerableKeyValueStore(backend)) {\n    throw new ItdConfigError('MultiTokenStorage требует KeyValueStore с методом keys()');\n  }\n  const key = (account: string) => `${prefix}${encodeURIComponent(account)}`;\n  return {\n    async get(account) {\n      const session = await backend.get(key(account));\n      return session ? copySession(session) : null;\n    },\n    set: (account, session) => backend.set(key(account), copySession(session)),\n    clear: (account) => backend.delete(key(account)),\n    async accounts() {\n      const keys = await collectKeyValueStoreKeys(backend, prefix);\n      return keys.flatMap((value) => readAccountName(value.slice(prefix.length)) ?? []);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/{options-DtATYdLr.js → options-BNP633A5.js}

@@ -1,4 +1,5 @@
-import { a as ItdConfigError, l as ItdFileError, u as ItdFileErrorReason } from "./errors-Bhrd2fJd.js";
+import { a as ItdConfigError, l as ItdFileError, u as ItdFileErrorReason } from "./errors-GI10kZxk.js";
+import { a as redactUrl, r as redactErrorCause } from "./redact-FNK29Fv-.js";
 //#region src/core/attachments/contracts.ts
 /** Способ передачи содержимого вложения. */
 const FileTransferMode = Object.freeze({
@@ -19,10 +20,11 @@ function optionalBytes(value, name) {
 }
 /** Создаёт типизированную ошибку превышения размера вложения. */
 function fileTooLarge(url, limit, actual) {
-	const source = url ? ` по адресу ${url}` : "";
+	const safeUrl = url ? redactUrl(url) : void 0;
+	const source = safeUrl ? ` по адресу ${safeUrl}` : "";
 	return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {
 		reason: ItdFileErrorReason.TooLarge,
-		...url ? { url } : {},
+		...safeUrl ? { url: safeUrl } : {},
 		limit,
 		actual
 	});
@@ -98,9 +100,9 @@ function boundedFileStream(source, options = {}) {
 				}
 				controller.error(new ItdFileError("не удалось прочитать поток вложения", {
 					reason: ItdFileErrorReason.Read,
-					...options.url ? { url: options.url } : {},
+					...options.url ? { url: redactUrl(options.url) } : {},
 					retryable: options.retryableRead ?? false,
-					cause: error
+					cause: redactErrorCause(error)
 				}));
 			}
 		},
@@ -139,4 +141,4 @@ function resolveFileStreamOptions(options, defaultMaxBytes) {
 //#endregion
 export { fileTooLarge as a, FileTransferMode as c, isReadableByteStream as i, boundedFileStream as n, optionalBytes as o, isBoundedFileStream as r, DEFAULT_URL_FILE_MAX_BYTES as s, resolveFileStreamOptions as t };
 
-//# sourceMappingURL=options-DtATYdLr.js.map
+//# sourceMappingURL=options-BNP633A5.js.map

package/dist/shared/options-BNP633A5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-BNP633A5.js","names":[],"sources":["../../src/core/attachments/contracts.ts","../../src/core/attachments/limits.ts","../../src/core/attachments/bounded-stream.ts","../../src/core/attachments/options.ts"],"sourcesContent":["/** Способ передачи содержимого вложения. */\nexport const FileTransferMode = Object.freeze({\n  /** Сначала получить файл целиком, затем отправить его как `Blob`. */\n  Buffer: 'buffer',\n  /** Передавать данные по мере чтения, не собирая файл целиком в памяти. */\n  Stream: 'stream',\n} as const);\nexport type FileTransferMode = (typeof FileTransferMode)[keyof typeof FileTransferMode];\n\n/** Размер очереди потокового вложения по умолчанию — 4 МиБ. */\nexport const DEFAULT_FILE_STREAM_BUFFER_BYTES = 4 * 1024 * 1024;\n\n/** Предел размера файла, скачиваемого по адресу, — 100 МиБ. */\nexport const DEFAULT_URL_FILE_MAX_BYTES = 100 * 1024 * 1024;\n\n/** Что доступно источнику при открытии файла. */\nexport interface FileContext {\n  /** Общая отмена текущей попытки, включая её таймаут. */\n  signal?: AbortSignal | undefined;\n  /** `fetch` клиента — с переданными пользователем настройками. */\n  fetch: typeof fetch;\n  /** Номер попытки отправки, начиная с 1. */\n  attempt: number;\n}\n\n/** Готовое содержимое файла. */\nexport interface FileContent {\n  file: Blob | ArrayBuffer | Uint8Array;\n  /** Имя влияет на определение MIME, если `contentType` не задан. */\n  filename?: string | undefined;\n  /** MIME без параметров. Если не указан, определяется по имени или `Blob`. */\n  contentType?: string | undefined;\n}\n\n/** Открытый поток файла. */\nexport interface FileStreamContent {\n  stream: ReadableStream<Uint8Array>;\n  filename?: string | undefined;\n  contentType?: string | undefined;\n  /** Размер, если он известен до чтения. */\n  size?: number | undefined;\n  /** Освобождает внешний ресурс после завершения попытки. */\n  close?: (() => void | Promise<void>) | undefined;\n}\n\n/** Буферный источник, который вычисляется непосредственно перед первой попыткой. */\nexport interface LazyFile {\n  load: (context: FileContext) => FileContent | Promise<FileContent>;\n}\n\n/**\n * Повторяемый потоковый источник.\n *\n * `open` вызывается для каждой попытки отправки. Он обязан возвращать новый поток:\n * уже прочитанный `ReadableStream` повторно использовать нельзя.\n */\nexport interface StreamFile {\n  open: (context: FileContext) => FileStreamContent | Promise<FileStreamContent>;\n}\n\n/** Общие настройки потоковой передачи. */\nexport interface FileStreamOptions {\n  /** Буферный или потоковый режим. По умолчанию `'buffer'`. */\n  mode?: FileTransferMode | undefined;\n  /** Максимальный размер файла. Без значения размер не ограничивается. */\n  maxBytes?: number | undefined;\n  /**\n   * Верхняя граница очереди, которой управляет библиотека. По умолчанию 4 МиБ.\n   *\n   * Сетевой рантайм может иметь собственные внутренние буферы сверх этого значения.\n   */\n  streamBufferBytes?: number | undefined;\n}\n\n/** Файл, который нужно получить по HTTP(S). */\nexport interface UrlFile extends UrlFileOptions {\n  url: string;\n}\n\n/** Настройки файла по HTTP(S). */\nexport interface UrlFileOptions extends FileStreamOptions {\n  filename?: string | undefined;\n  /** По умолчанию берётся из `Content-Type` ответа. */\n  contentType?: string | undefined;\n}\n\n/** Файл для загрузки. Голый поток не принимается, потому что его нельзя повторить. */\nexport type FileInput =\n  | Blob\n  | ArrayBuffer\n  | Uint8Array\n  | FileContent\n  | UrlFile\n  | LazyFile\n  | StreamFile;\n\n/** Настройки фабрики пользовательского потока. */\nexport interface FromStreamOptions extends Omit<FileStreamOptions, 'mode'> {\n  filename?: string | undefined;\n  contentType?: string | undefined;\n  /** Размер, если он известен заранее. */\n  size?: number | undefined;\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.js';\nimport { redactUrl } from '../redact.js';\n\n/** Проверяет числовую границу до обращения к источнику. */\nexport function optionalBytes(value: number | undefined, name: string): number | undefined {\n  if (value === undefined) return undefined;\n  if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) {\n    throw new ItdConfigError(\n      `${name} должен быть неотрицательным целым числом, получено: ${value}`,\n    );\n  }\n  return value;\n}\n\n/** Создаёт типизированную ошибку превышения размера вложения. */\nexport function fileTooLarge(url: string | undefined, limit: number, actual: number): ItdFileError {\n  const safeUrl = url ? redactUrl(url) : undefined;\n  const source = safeUrl ? ` по адресу ${safeUrl}` : '';\n  return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {\n    reason: ItdFileErrorReason.TooLarge,\n    ...(safeUrl ? { url: safeUrl } : {}),\n    limit,\n    actual,\n  });\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.js';\nimport { redactErrorCause, redactUrl } from '../redact.js';\nimport { DEFAULT_FILE_STREAM_BUFFER_BYTES } from './contracts.js';\nimport { fileTooLarge, optionalBytes } from './limits.js';\n\n/** Потоки, на которые уже наложены счётчик размера и backpressure. */\nconst BOUNDED_FILE_STREAMS = new WeakSet<ReadableStream<Uint8Array>>();\n\n/** Настройки ограничивающей поток обёртки. */\nexport interface BoundedFileStreamOptions {\n  maxBytes?: number | undefined;\n  streamBufferBytes?: number | undefined;\n  signal?: AbortSignal | undefined;\n  url?: string | undefined;\n  retryableRead?: boolean | undefined;\n}\n\n/** Приводит произвольный чанк потока к байтам. */\nfunction asBytes(value: Uint8Array): Uint8Array {\n  return value instanceof Uint8Array ? value : new Uint8Array(value);\n}\n\n/** Проверяет значение без обращения к методам потенциально чужого объекта. */\nexport function isReadableByteStream(value: unknown): value is ReadableStream<Uint8Array> {\n  return typeof ReadableStream !== 'undefined' && value instanceof ReadableStream;\n}\n\n/**\n * Ограничивает размер и очередь потока. Отмена результирующего потока отменяет исходный.\n *\n * @internal\n */\nexport function boundedFileStream(\n  source: ReadableStream<Uint8Array>,\n  options: BoundedFileStreamOptions = {},\n): ReadableStream<Uint8Array> {\n  const maxBytes = optionalBytes(options.maxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  const reader = source.getReader();\n  let total = 0;\n  let finished = false;\n  let abortListener: (() => void) | undefined;\n\n  const cleanup = () => {\n    if (abortListener) options.signal?.removeEventListener('abort', abortListener);\n    abortListener = undefined;\n  };\n\n  const stream = new ReadableStream<Uint8Array>(\n    {\n      start(controller) {\n        if (!options.signal) return;\n        abortListener = () => {\n          finished = true;\n          void reader.cancel(options.signal?.reason).catch(() => {});\n          controller.error(options.signal?.reason ?? new DOMException('Aborted', 'AbortError'));\n          cleanup();\n        };\n        if (options.signal.aborted) abortListener();\n        else options.signal.addEventListener('abort', abortListener, { once: true });\n      },\n      async pull(controller) {\n        if (finished) return;\n\n        try {\n          const next = await reader.read();\n          if (finished) return;\n          if (next.done) {\n            finished = true;\n            cleanup();\n            controller.close();\n            return;\n          }\n\n          const chunk = asBytes(next.value);\n          total += chunk.byteLength;\n          if (maxBytes !== undefined && total > maxBytes) {\n            finished = true;\n            await reader.cancel().catch(() => {});\n            cleanup();\n            controller.error(fileTooLarge(options.url, maxBytes, total));\n            return;\n          }\n\n          controller.enqueue(chunk);\n        } catch (error) {\n          finished = true;\n          cleanup();\n          if (error instanceof ItdFileError) {\n            controller.error(error);\n            return;\n          }\n          controller.error(\n            new ItdFileError('не удалось прочитать поток вложения', {\n              reason: ItdFileErrorReason.Read,\n              ...(options.url ? { url: redactUrl(options.url) } : {}),\n              retryable: options.retryableRead ?? false,\n              cause: redactErrorCause(error),\n            }),\n          );\n        }\n      },\n      async cancel(reason) {\n        finished = true;\n        cleanup();\n        await reader.cancel(reason).catch(() => {});\n      },\n    },\n    {\n      highWaterMark: streamBufferBytes,\n      size: (chunk) => chunk.byteLength,\n    },\n  );\n  BOUNDED_FILE_STREAMS.add(stream);\n  return stream;\n}\n\n/** Наложены ли на поток ограничения библиотеки. @internal */\nexport function isBoundedFileStream(stream: ReadableStream<Uint8Array>): boolean {\n  return BOUNDED_FILE_STREAMS.has(stream);\n}\n","import { ItdConfigError } from '../errors.js';\nimport {\n  DEFAULT_FILE_STREAM_BUFFER_BYTES,\n  type FileStreamOptions,\n  FileTransferMode,\n} from './contracts.js';\nimport { optionalBytes } from './limits.js';\n\n/** Проверяет и дополняет настройки потока. @internal */\nexport function resolveFileStreamOptions(\n  options: FileStreamOptions,\n  defaultMaxBytes?: number,\n): {\n  mode: FileTransferMode;\n  maxBytes: number | undefined;\n  streamBufferBytes: number;\n} {\n  const mode = options.mode ?? FileTransferMode.Buffer;\n  if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) {\n    throw new ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);\n  }\n  if (mode === FileTransferMode.Stream && typeof ReadableStream === 'undefined') {\n    throw new ItdConfigError(\n      \"эта среда не поддерживает ReadableStream; используйте mode: 'buffer'\",\n    );\n  }\n\n  const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  return { mode, maxBytes, streamBufferBytes };\n}\n"],"mappings":";;;;AACA,MAAa,mBAAmB,OAAO,OAAO;;CAE5C,QAAQ;;CAER,QAAQ;AACV,CAAU;;AAOV,MAAa,6BAA6B;;;;ACT1C,SAAgB,cAAc,OAA2B,MAAkC;CACzF,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;CAChC,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,CAAC,OAAO,UAAU,KAAK,GACjE,MAAM,IAAI,eACR,GAAG,KAAK,uDAAuD,OACjE;CAEF,OAAO;AACT;;AAGA,SAAgB,aAAa,KAAyB,OAAe,QAA8B;CACjG,MAAM,UAAU,MAAM,UAAU,GAAG,IAAI,KAAA;CACvC,MAAM,SAAS,UAAU,cAAc,YAAY;CACnD,OAAO,IAAI,aAAa,OAAO,OAAO,oBAAoB,MAAM,SAAS,UAAU;EACjF,QAAQ,mBAAmB;EAC3B,GAAI,UAAU,EAAE,KAAK,QAAQ,IAAI,CAAC;EAClC;EACA;CACF,CAAC;AACH;;;;AClBA,MAAM,uCAAuB,IAAI,QAAoC;;AAYrE,SAAS,QAAQ,OAA+B;CAC9C,OAAO,iBAAiB,aAAa,QAAQ,IAAI,WAAW,KAAK;AACnE;;AAGA,SAAgB,qBAAqB,OAAqD;CACxF,OAAO,OAAO,mBAAmB,eAAe,iBAAiB;AACnE;;;;;;AAOA,SAAgB,kBACd,QACA,UAAoC,CAAC,GACT;CAC5B,MAAM,WAAW,cAAc,QAAQ,UAAU,UAAU;CAC3D,MAAM,oBACJ,cACE,QAAQ,qBAAA,SACR,mBACF,KAAA;CACF,IAAI,sBAAsB,GACxB,MAAM,IAAI,eAAe,2CAA2C;CAGtE,MAAM,SAAS,OAAO,UAAU;CAChC,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI;CAEJ,MAAM,gBAAgB;EACpB,IAAI,eAAe,QAAQ,QAAQ,oBAAoB,SAAS,aAAa;EAC7E,gBAAgB,KAAA;CAClB;CAEA,MAAM,SAAS,IAAI,eACjB;EACE,MAAM,YAAY;GAChB,IAAI,CAAC,QAAQ,QAAQ;GACrB,sBAAsB;IACpB,WAAW;IACX,OAAY,OAAO,QAAQ,QAAQ,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACzD,WAAW,MAAM,QAAQ,QAAQ,UAAU,IAAI,aAAa,WAAW,YAAY,CAAC;IACpF,QAAQ;GACV;GACA,IAAI,QAAQ,OAAO,SAAS,cAAc;QACrC,QAAQ,OAAO,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;EAC7E;EACA,MAAM,KAAK,YAAY;GACrB,IAAI,UAAU;GAEd,IAAI;IACF,MAAM,OAAO,MAAM,OAAO,KAAK;IAC/B,IAAI,UAAU;IACd,IAAI,KAAK,MAAM;KACb,WAAW;KACX,QAAQ;KACR,WAAW,MAAM;KACjB;IACF;IAEA,MAAM,QAAQ,QAAQ,KAAK,KAAK;IAChC,SAAS,MAAM;IACf,IAAI,aAAa,KAAA,KAAa,QAAQ,UAAU;KAC9C,WAAW;KACX,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;KACpC,QAAQ;KACR,WAAW,MAAM,aAAa,QAAQ,KAAK,UAAU,KAAK,CAAC;KAC3D;IACF;IAEA,WAAW,QAAQ,KAAK;GAC1B,SAAS,OAAO;IACd,WAAW;IACX,QAAQ;IACR,IAAI,iBAAiB,cAAc;KACjC,WAAW,MAAM,KAAK;KACtB;IACF;IACA,WAAW,MACT,IAAI,aAAa,uCAAuC;KACtD,QAAQ,mBAAmB;KAC3B,GAAI,QAAQ,MAAM,EAAE,KAAK,UAAU,QAAQ,GAAG,EAAE,IAAI,CAAC;KACrD,WAAW,QAAQ,iBAAiB;KACpC,OAAO,iBAAiB,KAAK;IAC/B,CAAC,CACH;GACF;EACF;EACA,MAAM,OAAO,QAAQ;GACnB,WAAW;GACX,QAAQ;GACR,MAAM,OAAO,OAAO,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;EAC5C;CACF,GACA;EACE,eAAe;EACf,OAAO,UAAU,MAAM;CACzB,CACF;CACA,qBAAqB,IAAI,MAAM;CAC/B,OAAO;AACT;;AAGA,SAAgB,oBAAoB,QAA6C;CAC/E,OAAO,qBAAqB,IAAI,MAAM;AACxC;;;;ACvHA,SAAgB,yBACd,SACA,iBAKA;CACA,MAAM,OAAO,QAAQ,QAAQ,iBAAiB;CAC9C,IAAI,SAAS,iBAAiB,UAAU,SAAS,iBAAiB,QAChE,MAAM,IAAI,eAAe,8DAA8D,MAAM;CAE/F,IAAI,SAAS,iBAAiB,UAAU,OAAO,mBAAmB,aAChE,MAAM,IAAI,eACR,sEACF;CAGF,MAAM,WAAW,cAAc,QAAQ,YAAY,iBAAiB,UAAU;CAC9E,MAAM,oBACJ,cACE,QAAQ,qBAAA,SACR,mBACF,KAAA;CACF,IAAI,sBAAsB,GACxB,MAAM,IAAI,eAAe,2CAA2C;CAGtE,OAAO;EAAE;EAAM;EAAU;CAAkB;AAC7C"}

package/dist/shared/{options-Dg5N3r1V.cjs → options-BUfoHE9G.cjs}

@@ -1,4 +1,5 @@
-const require_errors = require("./errors-DfU8M5eS.cjs");
+const require_errors = require("./errors-BmP3TKoW.cjs");
+const require_redact = require("./redact-DB9EMGJx.cjs");
 //#region src/core/attachments/contracts.ts
 /** Способ передачи содержимого вложения. */
 const FileTransferMode = Object.freeze({
@@ -19,10 +20,11 @@ function optionalBytes(value, name) {
 }
 /** Создаёт типизированную ошибку превышения размера вложения. */
 function fileTooLarge(url, limit, actual) {
-	const source = url ? ` по адресу ${url}` : "";
+	const safeUrl = url ? require_redact.redactUrl(url) : void 0;
+	const source = safeUrl ? ` по адресу ${safeUrl}` : "";
 	return new require_errors.ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {
 		reason: require_errors.ItdFileErrorReason.TooLarge,
-		...url ? { url } : {},
+		...safeUrl ? { url: safeUrl } : {},
 		limit,
 		actual
 	});
@@ -98,9 +100,9 @@ function boundedFileStream(source, options = {}) {
 				}
 				controller.error(new require_errors.ItdFileError("не удалось прочитать поток вложения", {
 					reason: require_errors.ItdFileErrorReason.Read,
-					...options.url ? { url: options.url } : {},
+					...options.url ? { url: require_redact.redactUrl(options.url) } : {},
 					retryable: options.retryableRead ?? false,
-					cause: error
+					cause: require_redact.redactErrorCause(error)
 				}));
 			}
 		},
@@ -186,4 +188,4 @@ Object.defineProperty(exports, "resolveFileStreamOptions", {
 	}
 });
 
-//# sourceMappingURL=options-Dg5N3r1V.cjs.map
+//# sourceMappingURL=options-BUfoHE9G.cjs.map

package/dist/shared/options-BUfoHE9G.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-BUfoHE9G.cjs","names":["ItdConfigError","redactUrl","ItdFileError","ItdFileErrorReason","ItdConfigError","ItdFileError","ItdFileErrorReason","redactUrl","redactErrorCause","ItdConfigError"],"sources":["../../src/core/attachments/contracts.ts","../../src/core/attachments/limits.ts","../../src/core/attachments/bounded-stream.ts","../../src/core/attachments/options.ts"],"sourcesContent":["/** Способ передачи содержимого вложения. */\nexport const FileTransferMode = Object.freeze({\n  /** Сначала получить файл целиком, затем отправить его как `Blob`. */\n  Buffer: 'buffer',\n  /** Передавать данные по мере чтения, не собирая файл целиком в памяти. */\n  Stream: 'stream',\n} as const);\nexport type FileTransferMode = (typeof FileTransferMode)[keyof typeof FileTransferMode];\n\n/** Размер очереди потокового вложения по умолчанию — 4 МиБ. */\nexport const DEFAULT_FILE_STREAM_BUFFER_BYTES = 4 * 1024 * 1024;\n\n/** Предел размера файла, скачиваемого по адресу, — 100 МиБ. */\nexport const DEFAULT_URL_FILE_MAX_BYTES = 100 * 1024 * 1024;\n\n/** Что доступно источнику при открытии файла. */\nexport interface FileContext {\n  /** Общая отмена текущей попытки, включая её таймаут. */\n  signal?: AbortSignal | undefined;\n  /** `fetch` клиента — с переданными пользователем настройками. */\n  fetch: typeof fetch;\n  /** Номер попытки отправки, начиная с 1. */\n  attempt: number;\n}\n\n/** Готовое содержимое файла. */\nexport interface FileContent {\n  file: Blob | ArrayBuffer | Uint8Array;\n  /** Имя влияет на определение MIME, если `contentType` не задан. */\n  filename?: string | undefined;\n  /** MIME без параметров. Если не указан, определяется по имени или `Blob`. */\n  contentType?: string | undefined;\n}\n\n/** Открытый поток файла. */\nexport interface FileStreamContent {\n  stream: ReadableStream<Uint8Array>;\n  filename?: string | undefined;\n  contentType?: string | undefined;\n  /** Размер, если он известен до чтения. */\n  size?: number | undefined;\n  /** Освобождает внешний ресурс после завершения попытки. */\n  close?: (() => void | Promise<void>) | undefined;\n}\n\n/** Буферный источник, который вычисляется непосредственно перед первой попыткой. */\nexport interface LazyFile {\n  load: (context: FileContext) => FileContent | Promise<FileContent>;\n}\n\n/**\n * Повторяемый потоковый источник.\n *\n * `open` вызывается для каждой попытки отправки. Он обязан возвращать новый поток:\n * уже прочитанный `ReadableStream` повторно использовать нельзя.\n */\nexport interface StreamFile {\n  open: (context: FileContext) => FileStreamContent | Promise<FileStreamContent>;\n}\n\n/** Общие настройки потоковой передачи. */\nexport interface FileStreamOptions {\n  /** Буферный или потоковый режим. По умолчанию `'buffer'`. */\n  mode?: FileTransferMode | undefined;\n  /** Максимальный размер файла. Без значения размер не ограничивается. */\n  maxBytes?: number | undefined;\n  /**\n   * Верхняя граница очереди, которой управляет библиотека. По умолчанию 4 МиБ.\n   *\n   * Сетевой рантайм может иметь собственные внутренние буферы сверх этого значения.\n   */\n  streamBufferBytes?: number | undefined;\n}\n\n/** Файл, который нужно получить по HTTP(S). */\nexport interface UrlFile extends UrlFileOptions {\n  url: string;\n}\n\n/** Настройки файла по HTTP(S). */\nexport interface UrlFileOptions extends FileStreamOptions {\n  filename?: string | undefined;\n  /** По умолчанию берётся из `Content-Type` ответа. */\n  contentType?: string | undefined;\n}\n\n/** Файл для загрузки. Голый поток не принимается, потому что его нельзя повторить. */\nexport type FileInput =\n  | Blob\n  | ArrayBuffer\n  | Uint8Array\n  | FileContent\n  | UrlFile\n  | LazyFile\n  | StreamFile;\n\n/** Настройки фабрики пользовательского потока. */\nexport interface FromStreamOptions extends Omit<FileStreamOptions, 'mode'> {\n  filename?: string | undefined;\n  contentType?: string | undefined;\n  /** Размер, если он известен заранее. */\n  size?: number | undefined;\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.js';\nimport { redactUrl } from '../redact.js';\n\n/** Проверяет числовую границу до обращения к источнику. */\nexport function optionalBytes(value: number | undefined, name: string): number | undefined {\n  if (value === undefined) return undefined;\n  if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) {\n    throw new ItdConfigError(\n      `${name} должен быть неотрицательным целым числом, получено: ${value}`,\n    );\n  }\n  return value;\n}\n\n/** Создаёт типизированную ошибку превышения размера вложения. */\nexport function fileTooLarge(url: string | undefined, limit: number, actual: number): ItdFileError {\n  const safeUrl = url ? redactUrl(url) : undefined;\n  const source = safeUrl ? ` по адресу ${safeUrl}` : '';\n  return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {\n    reason: ItdFileErrorReason.TooLarge,\n    ...(safeUrl ? { url: safeUrl } : {}),\n    limit,\n    actual,\n  });\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.js';\nimport { redactErrorCause, redactUrl } from '../redact.js';\nimport { DEFAULT_FILE_STREAM_BUFFER_BYTES } from './contracts.js';\nimport { fileTooLarge, optionalBytes } from './limits.js';\n\n/** Потоки, на которые уже наложены счётчик размера и backpressure. */\nconst BOUNDED_FILE_STREAMS = new WeakSet<ReadableStream<Uint8Array>>();\n\n/** Настройки ограничивающей поток обёртки. */\nexport interface BoundedFileStreamOptions {\n  maxBytes?: number | undefined;\n  streamBufferBytes?: number | undefined;\n  signal?: AbortSignal | undefined;\n  url?: string | undefined;\n  retryableRead?: boolean | undefined;\n}\n\n/** Приводит произвольный чанк потока к байтам. */\nfunction asBytes(value: Uint8Array): Uint8Array {\n  return value instanceof Uint8Array ? value : new Uint8Array(value);\n}\n\n/** Проверяет значение без обращения к методам потенциально чужого объекта. */\nexport function isReadableByteStream(value: unknown): value is ReadableStream<Uint8Array> {\n  return typeof ReadableStream !== 'undefined' && value instanceof ReadableStream;\n}\n\n/**\n * Ограничивает размер и очередь потока. Отмена результирующего потока отменяет исходный.\n *\n * @internal\n */\nexport function boundedFileStream(\n  source: ReadableStream<Uint8Array>,\n  options: BoundedFileStreamOptions = {},\n): ReadableStream<Uint8Array> {\n  const maxBytes = optionalBytes(options.maxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  const reader = source.getReader();\n  let total = 0;\n  let finished = false;\n  let abortListener: (() => void) | undefined;\n\n  const cleanup = () => {\n    if (abortListener) options.signal?.removeEventListener('abort', abortListener);\n    abortListener = undefined;\n  };\n\n  const stream = new ReadableStream<Uint8Array>(\n    {\n      start(controller) {\n        if (!options.signal) return;\n        abortListener = () => {\n          finished = true;\n          void reader.cancel(options.signal?.reason).catch(() => {});\n          controller.error(options.signal?.reason ?? new DOMException('Aborted', 'AbortError'));\n          cleanup();\n        };\n        if (options.signal.aborted) abortListener();\n        else options.signal.addEventListener('abort', abortListener, { once: true });\n      },\n      async pull(controller) {\n        if (finished) return;\n\n        try {\n          const next = await reader.read();\n          if (finished) return;\n          if (next.done) {\n            finished = true;\n            cleanup();\n            controller.close();\n            return;\n          }\n\n          const chunk = asBytes(next.value);\n          total += chunk.byteLength;\n          if (maxBytes !== undefined && total > maxBytes) {\n            finished = true;\n            await reader.cancel().catch(() => {});\n            cleanup();\n            controller.error(fileTooLarge(options.url, maxBytes, total));\n            return;\n          }\n\n          controller.enqueue(chunk);\n        } catch (error) {\n          finished = true;\n          cleanup();\n          if (error instanceof ItdFileError) {\n            controller.error(error);\n            return;\n          }\n          controller.error(\n            new ItdFileError('не удалось прочитать поток вложения', {\n              reason: ItdFileErrorReason.Read,\n              ...(options.url ? { url: redactUrl(options.url) } : {}),\n              retryable: options.retryableRead ?? false,\n              cause: redactErrorCause(error),\n            }),\n          );\n        }\n      },\n      async cancel(reason) {\n        finished = true;\n        cleanup();\n        await reader.cancel(reason).catch(() => {});\n      },\n    },\n    {\n      highWaterMark: streamBufferBytes,\n      size: (chunk) => chunk.byteLength,\n    },\n  );\n  BOUNDED_FILE_STREAMS.add(stream);\n  return stream;\n}\n\n/** Наложены ли на поток ограничения библиотеки. @internal */\nexport function isBoundedFileStream(stream: ReadableStream<Uint8Array>): boolean {\n  return BOUNDED_FILE_STREAMS.has(stream);\n}\n","import { ItdConfigError } from '../errors.js';\nimport {\n  DEFAULT_FILE_STREAM_BUFFER_BYTES,\n  type FileStreamOptions,\n  FileTransferMode,\n} from './contracts.js';\nimport { optionalBytes } from './limits.js';\n\n/** Проверяет и дополняет настройки потока. @internal */\nexport function resolveFileStreamOptions(\n  options: FileStreamOptions,\n  defaultMaxBytes?: number,\n): {\n  mode: FileTransferMode;\n  maxBytes: number | undefined;\n  streamBufferBytes: number;\n} {\n  const mode = options.mode ?? FileTransferMode.Buffer;\n  if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) {\n    throw new ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);\n  }\n  if (mode === FileTransferMode.Stream && typeof ReadableStream === 'undefined') {\n    throw new ItdConfigError(\n      \"эта среда не поддерживает ReadableStream; используйте mode: 'buffer'\",\n    );\n  }\n\n  const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  return { mode, maxBytes, streamBufferBytes };\n}\n"],"mappings":"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"}

package/dist/shared/{cookies-DZwFq6kr.cjs → redact-DB9EMGJx.cjs}

@@ -1,4 +1,118 @@
-const require_errors = require("./errors-DfU8M5eS.cjs");
+const require_errors = require("./errors-BmP3TKoW.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_errors.ItdConfigError("fetch должен быть функцией");
+		return custom;
+	}
+	if (typeof globalThis.fetch === "function") return globalThis.fetch.bind(globalThis);
+	throw new require_errors.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("-");
+}
+//#endregion
 //#region src/core/url.ts
 /**
 * Собирает строку запроса.
@@ -421,6 +535,113 @@ var CookieJar = class {
 	}
 };
 //#endregion
+//#region src/core/redact.ts
+/** Заголовки, значение которых нельзя писать в лог целиком. */
+const SECRET_HEADERS = /* @__PURE__ */ new Set([
+	"authorization",
+	"cookie",
+	"set-cookie",
+	"x-api-key"
+]);
+/** Поля тела запроса, значение которых нельзя писать в лог. */
+const SECRET_FIELDS = /* @__PURE__ */ new Set([
+	"password",
+	"oldpassword",
+	"newpassword",
+	"accesstoken",
+	"refreshtoken",
+	"currentpassword",
+	"flowtoken",
+	"token",
+	"turnstiletoken",
+	"otp"
+]);
+/** Query-параметры, содержащие секреты. */
+const SECRET_QUERY_PARAMS = /* @__PURE__ */ new Set([
+	"token",
+	"access_token",
+	"c"
+]);
+/**
+* Прячет середину секрета, оставляя концы для сопоставления.
+*
+* @example
+* ```ts
+* maskSecret('eyJhbGciOiJIUzI1NiJ9.abc'); // 'eyJh…(24)…abc'
+* ```
+*/
+function maskSecret(value) {
+	if (value.length <= 8) return "…";
+	return `${value.slice(0, 4)}…(${value.length})…${value.slice(-3)}`;
+}
+/** Маскирует секретные query-параметры URL перед записью в логи и ошибки. */
+function redactUrl(url) {
+	try {
+		const parsed = new URL(url);
+		const entries = [...parsed.searchParams.entries()];
+		parsed.search = "";
+		for (const [name, value] of entries) parsed.searchParams.append(name, SECRET_QUERY_PARAMS.has(name.toLowerCase()) ? maskSecret(value) : value);
+		return parsed.toString();
+	} catch {
+		return url.replace(/([?&](?:token|access_token|c)=)[^&#]*/gi, "$1[скрыто]");
+	}
+}
+/** Маскирует подписанные адреса внутри произвольного диагностического текста. */
+function redactUrlsInText(text) {
+	return text.replace(/https?:\/\/[^\s"'<>]+/gi, (url) => redactUrl(url));
+}
+/**
+* Создаёт безопасную причину ошибки для публичной цепочки `cause`.
+*
+* Чужие объекты не сохраняются: их поля и пользовательские методы нельзя надёжно
+* сериализовать без риска вывести секрет. Для Error и строк остаются тип и сообщение,
+* но все встреченные в сообщении HTTP(S)-адреса проходят маскирование.
+*/
+function redactErrorCause(error) {
+	const message = error instanceof Error ? error.message : typeof error === "string" ? error : void 0;
+	if (message === void 0) return void 0;
+	const safeMessage = redactUrlsInText(message);
+	const safe = error instanceof TypeError ? new TypeError(safeMessage) : new Error(safeMessage);
+	if (error instanceof Error && !(error instanceof TypeError)) safe.name = error.name;
+	return safe;
+}
+/**
+* Готовит заголовки к записи в лог.
+*
+* `Authorization` и `Cookie` маскируются: логи часто уезжают в системы сбора,
+* и токен доступа в них попадать не должен.
+*/
+function redactHeaders(headers) {
+	const result = {};
+	headers.forEach((value, name) => {
+		if (SECRET_HEADERS.has(name.toLowerCase())) {
+			const spaceAt = value.indexOf(" ");
+			result[name] = spaceAt > 0 ? `${value.slice(0, spaceAt)} ${maskSecret(value.slice(spaceAt + 1))}` : maskSecret(value);
+			return;
+		}
+		result[name] = value;
+	});
+	return result;
+}
+/**
+* Готовит тело запроса к записи в лог: пароли, токены и коды OTP заменяются заглушкой.
+*
+* Обходит вложенные объекты и массивы. `FormData` и бинарные тела не раскрываются вовсе.
+*/
+function redactBody(body) {
+	if (body === null || body === void 0) return body;
+	if (typeof FormData !== "undefined" && body instanceof FormData) return "[FormData]";
+	if (isBlob(body)) return "[Blob]";
+	if (body instanceof ArrayBuffer || ArrayBuffer.isView(body)) return "[binary]";
+	if (Array.isArray(body)) return body.map(redactBody);
+	if (typeof body === "object") {
+		const result = {};
+		for (const [key, value] of Object.entries(body)) result[key] = SECRET_FIELDS.has(key.toLowerCase()) ? "[скрыто]" : redactBody(value);
+		return result;
+	}
+	return body;
+}
+//#endregion
 Object.defineProperty(exports, "AUTH_FLAG_COOKIE", {
 	enumerable: true,
 	get: function() {
@@ -445,12 +666,24 @@ Object.defineProperty(exports, "REFRESH_COOKIE_PATH", {
 		return REFRESH_COOKIE_PATH;
 	}
 });
+Object.defineProperty(exports, "RuntimeMode", {
+	enumerable: true,
+	get: function() {
+		return RuntimeMode;
+	}
+});
 Object.defineProperty(exports, "buildQuery", {
 	enumerable: true,
 	get: function() {
 		return buildQuery;
 	}
 });
+Object.defineProperty(exports, "createDeviceId", {
+	enumerable: true,
+	get: function() {
+		return createDeviceId;
+	}
+});
 Object.defineProperty(exports, "encodePathSegment", {
 	enumerable: true,
 	get: function() {
@@ -463,6 +696,18 @@ Object.defineProperty(exports, "hostOf", {
 		return hostOf;
 	}
 });
+Object.defineProperty(exports, "isBlob", {
+	enumerable: true,
+	get: function() {
+		return isBlob;
+	}
+});
+Object.defineProperty(exports, "isFile", {
+	enumerable: true,
+	get: function() {
+		return isFile;
+	}
+});
 Object.defineProperty(exports, "isSameSite", {
 	enumerable: true,
 	get: function() {
@@ -475,6 +720,12 @@ Object.defineProperty(exports, "joinUrl", {
 		return joinUrl;
 	}
 });
+Object.defineProperty(exports, "maskSecret", {
+	enumerable: true,
+	get: function() {
+		return maskSecret;
+	}
+});
 Object.defineProperty(exports, "normalizeBaseUrl", {
 	enumerable: true,
 	get: function() {
@@ -487,5 +738,53 @@ Object.defineProperty(exports, "originOf", {
 		return originOf;
 	}
 });
+Object.defineProperty(exports, "redactBody", {
+	enumerable: true,
+	get: function() {
+		return redactBody;
+	}
+});
+Object.defineProperty(exports, "redactErrorCause", {
+	enumerable: true,
+	get: function() {
+		return redactErrorCause;
+	}
+});
+Object.defineProperty(exports, "redactHeaders", {
+	enumerable: true,
+	get: function() {
+		return redactHeaders;
+	}
+});
+Object.defineProperty(exports, "redactUrl", {
+	enumerable: true,
+	get: function() {
+		return redactUrl;
+	}
+});
+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=cookies-DZwFq6kr.cjs.map
+//# sourceMappingURL=redact-DB9EMGJx.cjs.map