itd-api 0.10.3 → 0.11.0

package/dist/shared/{events-D0Wtt-If.d.cts → events-Sc75x6rT.d.cts}

@@ -1,4 +1,4 @@
-import { Ft as RuntimeOptions, It as QueryParams, Vt as ItdClock, a as NotificationEvent, ct as Listener, dn as EventChannelStatus, lt as Unsubscribe, nt as AuthIdentity, rt as AuthProvider, s as Notification, tt as ClientConnection, vn as NotificationType, xt as Logger } from "./url-BLnX-LYt.cjs";
+import { Ft as RuntimeOptions, Ht as Logger, It as QueryParams, Ut as ItdClock, a as NotificationEvent, at as ClientConnection, bn as NotificationType, it as Unsubscribe, ot as AuthIdentity, pn as EventChannelStatus, rt as Listener, s as Notification, st as AuthProvider } from "./url-BOi-_mJT.cjs";
 //#region src/events/transports/transport.d.ts
 /** Идентификаторы операций транспорта уведомлений. */
 type EventOperationId = 'events.notifications.poll.updates' | 'events.notifications.poll.unread';
@@ -693,4 +693,4 @@ declare class WebSocketTransport implements EventTransport {
 }
 //#endregion
 export { EventTransportContext as $, EventHandler as A, NotificationEventContext as B, EventChannelDeps as C, EventSession as D, EventEnqueueOptions as E, EventSequentializer as F, NotificationOfType as G, NotificationEventOfType as H, EventTypeGuard as I, NotificationUpdateOrigin as J, NotificationUpdate as K, runEventMiddleware as L, EventMiddlewareObject as M, EventNext as N, EventSyncReason as O, EventPredicate as P, EventTransport as Q, EventContext as R, EventChannel as S, EventChannelOptions as T, NotificationEventSelector as U, NotificationEventFilter as V, NotificationEventsUpdate as W, UnknownNotificationUpdate as X, NotificationUpdateType as Y, UnreadCountUpdate as Z, createNotificationEventsClient as _, WebSocketTransportOptions as a, NotificationEventsOptions as b, EventErrorContext as c, EventMiddlewareLike as d, EventTransportFrame as et, EventRouteTable as f, NotificationEventsClientOptions as g, NotificationEventsClient as h, WebSocketTransport as i, EventMiddleware as j, ReconnectOptions as k, EventFilter as l, EventRouter as m, WebSocketLike as n, EventComposer as o, EventRouteSelector as p, NotificationUpdateOfType as q, WebSocketOpenFailureClassifier as r, EventErrorBoundary as s, WebSocketImplementationOptions as t, UnauthorizedStreamError as tt, EventMiddlewareGroup as u, NotificationEvents as v, EventChannelEvents as w, NotificationEventsTransport as x, NotificationEventsMap as y, NotificationContext as z };
-//# sourceMappingURL=events-D0Wtt-If.d.cts.map
+//# sourceMappingURL=events-Sc75x6rT.d.cts.map

package/dist/shared/{key-value-store-B5GYVEYZ.cjs → key-value-store-DYSPsqwq.cjs}

@@ -1,17 +1,14 @@
-const require_errors = require("./errors-BmP3TKoW.cjs");
+const require_validate = require("./validate-CFx2dISs.cjs");
 //#region src/core/key-value-store.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function requireStore(value) {
 	const store = value;
-	if (!isRecord(store)) throw new require_errors.ItdConfigError("KeyValueStore должен быть объектом");
+	if (!require_validate.isObjectLike(store)) throw new require_validate.ItdConfigError("KeyValueStore должен быть объектом");
 	for (const method of [
 		"get",
 		"set",
 		"delete"
-	]) if (typeof store[method] !== "function") throw new require_errors.ItdConfigError(`KeyValueStore.${method} должен быть функцией`);
-	if (store.keys !== void 0 && typeof store.keys !== "function") throw new require_errors.ItdConfigError("KeyValueStore.keys должен быть функцией");
+	]) if (typeof store[method] !== "function") throw new require_validate.ItdConfigError(`KeyValueStore.${method} должен быть функцией`);
+	if (store.keys !== void 0 && typeof store.keys !== "function") throw new require_validate.ItdConfigError("KeyValueStore.keys должен быть функцией");
 }
 /** Собирает {@link KeyValueStore} из функций конкретного backend. */
 function createKeyValueStore(handlers) {
@@ -27,7 +24,7 @@ async function collectKeyValueStoreKeys(store, prefix) {
 	const source = await store.keys(prefix);
 	const result = [];
 	for await (const key of source) {
-		if (typeof key !== "string") throw new require_errors.ItdConfigError("KeyValueStore.keys() должен возвращать только строки");
+		if (typeof key !== "string") throw new require_validate.ItdConfigError("KeyValueStore.keys() должен возвращать только строки");
 		if (prefix === void 0 || key.startsWith(prefix)) result.push(key);
 	}
 	return result;
@@ -54,7 +51,7 @@ var MemoryKeyValueStore = class {
 /** Добавляет namespace ко всем ключам, не меняя исходный backend. */
 function withNamespace(store, namespace, separator = ":") {
 	requireStore(store);
-	if (typeof namespace !== "string" || typeof separator !== "string") throw new require_errors.ItdConfigError("namespace и separator KeyValueStore должны быть строками");
+	if (typeof namespace !== "string" || typeof separator !== "string") throw new require_validate.ItdConfigError("namespace и separator KeyValueStore должны быть строками");
 	const base = namespace.length === 0 ? "" : `${namespace}${separator}`;
 	const key = (value) => `${base}${value}`;
 	const namespaced = {
@@ -70,7 +67,7 @@ function withNamespace(store, namespace, separator = ":") {
 /** Преобразует значения на границе backend, сохраняя его пространство ключей. */
 function withCodec(store, codec) {
 	requireStore(store);
-	if (!isRecord(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new require_errors.ItdConfigError("codec должен содержать функции encode и decode");
+	if (!require_validate.isObjectLike(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new require_validate.ItdConfigError("codec должен содержать функции encode и decode");
 	const encoded = {
 		async get(key) {
 			const value = await store.get(key);
@@ -101,15 +98,15 @@ function copyRecord(record) {
 * требуют внешней синхронизации со стороны source.
 */
 function createRecordKeyValueStore(source) {
-	if (!isRecord(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new require_errors.ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
-	if (source.delete !== void 0 && typeof source.delete !== "function") throw new require_errors.ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
+	if (!require_validate.isObjectLike(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new require_validate.ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
+	if (source.delete !== void 0 && typeof source.delete !== "function") throw new require_validate.ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
 	let committed;
 	let loading;
 	let writes = Promise.resolve();
 	const load = async () => {
 		if (committed !== void 0) return committed;
 		loading ??= Promise.resolve(source.read()).then((value) => {
-			if (value !== void 0 && !isRecord(value)) throw new require_errors.ItdConfigError("RecordKeyValueStoreSource.read() должен вернуть объект");
+			if (value !== void 0 && !require_validate.isRecord(value)) throw new require_validate.ItdConfigError("RecordKeyValueStoreSource.read() должен вернуть объект");
 			committed = copyRecord(value);
 			return committed;
 		}).finally(() => {
@@ -203,4 +200,4 @@ Object.defineProperty(exports, "withNamespace", {
 	}
 });
 
-//# sourceMappingURL=key-value-store-B5GYVEYZ.cjs.map
+//# sourceMappingURL=key-value-store-DYSPsqwq.cjs.map

package/dist/shared/key-value-store-DYSPsqwq.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store-DYSPsqwq.cjs","names":["isObjectLike","ItdConfigError","#values","isRecord"],"sources":["../../src/core/key-value-store.ts"],"sourcesContent":["import { ItdConfigError } from './errors.js';\nimport { isObjectLike, isRecord } from './validate.js';\n\n/** Синхронный или асинхронный результат операции хранилища. */\nexport type KeyValueStoreResult<T> = T | Promise<T>;\n\n/** Синхронный или асинхронный источник ключей. */\nexport type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;\n\n/**\n * Минимальный backend именованных значений.\n *\n * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение\n * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.\n */\nexport interface KeyValueStore<T> {\n  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */\n  get(key: string): KeyValueStoreResult<T | undefined>;\n  /** Полностью заменяет значение ключа. */\n  set(key: string, value: T): KeyValueStoreResult<void>;\n  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */\n  delete(key: string): KeyValueStoreResult<void>;\n  /** Перечисляет ключи, при возможности ограничивая их префиксом. */\n  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Backend, который гарантированно умеет перечислять ключи. */\nexport interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {\n  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Кодирует значения для хранения в backend другого типа. */\nexport interface KeyValueCodec<T, Stored> {\n  /** Преобразует доменное значение перед записью. */\n  encode(value: T): KeyValueStoreResult<Stored>;\n  /** Восстанавливает доменное значение после чтения. */\n  decode(value: Stored): KeyValueStoreResult<T>;\n}\n\n/** Источник одной записи, содержащей всю карту key-value. */\nexport interface RecordKeyValueStoreSource<T> {\n  /** Читает всю карту. `undefined` означает отсутствие записи. */\n  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;\n  /** Записывает стабильный снимок всей карты. */\n  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;\n  /** Удаляет запись, когда карта становится пустой. */\n  delete?(): KeyValueStoreResult<void>;\n}\n\nfunction requireStore(value: unknown): asserts value is KeyValueStore<unknown> {\n  const store = value as KeyValueStore<unknown>;\n  if (!isObjectLike(store)) throw new ItdConfigError('KeyValueStore должен быть объектом');\n  for (const method of ['get', 'set', 'delete'] as const) {\n    if (typeof store[method] !== 'function') {\n      throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);\n    }\n  }\n  if (store.keys !== undefined && typeof store.keys !== 'function') {\n    throw new ItdConfigError('KeyValueStore.keys должен быть функцией');\n  }\n}\n\nexport function createKeyValueStore<T>(\n  handlers: EnumerableKeyValueStore<T>,\n): EnumerableKeyValueStore<T>;\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;\n/** Собирает {@link KeyValueStore} из функций конкретного backend. */\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T> {\n  requireStore(handlers);\n  return handlers;\n}\n\n/** Проверяет доступность перечисления ключей. */\nexport function isEnumerableKeyValueStore<T>(\n  store: KeyValueStore<T>,\n): store is EnumerableKeyValueStore<T> {\n  return typeof store.keys === 'function';\n}\n\n/** @internal */\nexport async function collectKeyValueStoreKeys<T>(\n  store: EnumerableKeyValueStore<T>,\n  prefix?: string,\n): Promise<string[]> {\n  const source = await store.keys(prefix);\n  const result: string[] = [];\n  for await (const key of source) {\n    if (typeof key !== 'string') {\n      throw new ItdConfigError('KeyValueStore.keys() должен возвращать только строки');\n    }\n    if (prefix === undefined || key.startsWith(prefix)) result.push(key);\n  }\n  return result;\n}\n\n/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */\nexport class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {\n  readonly #values = new Map<string, T>();\n\n  constructor(initial?: Iterable<readonly [string, T]>) {\n    for (const [key, value] of initial ?? []) this.#values.set(key, value);\n  }\n\n  get(key: string): T | undefined {\n    return this.#values.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#values.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#values.delete(key);\n  }\n\n  keys(prefix = ''): string[] {\n    return [...this.#values.keys()].filter((key) => key.startsWith(prefix));\n  }\n}\n\nexport function withNamespace<T>(\n  store: EnumerableKeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): EnumerableKeyValueStore<T>;\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): KeyValueStore<T>;\n/** Добавляет namespace ко всем ключам, не меняя исходный backend. */\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator = ':',\n): KeyValueStore<T> {\n  requireStore(store);\n  if (typeof namespace !== 'string' || typeof separator !== 'string') {\n    throw new ItdConfigError('namespace и separator KeyValueStore должны быть строками');\n  }\n  const base = namespace.length === 0 ? '' : `${namespace}${separator}`;\n  const key = (value: string) => `${base}${value}`;\n  const namespaced: KeyValueStore<T> = {\n    get: (value) => store.get(key(value)),\n    set: (value, data) => store.set(key(value), data),\n    delete: (value) => store.delete(key(value)),\n  };\n\n  if (isEnumerableKeyValueStore(store)) {\n    namespaced.keys = async (prefix = '') => {\n      const keys = await collectKeyValueStoreKeys(store, key(prefix));\n      return keys.map((value) => value.slice(base.length));\n    };\n  }\n  return namespaced;\n}\n\nexport function withCodec<T, Stored>(\n  store: EnumerableKeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): EnumerableKeyValueStore<T>;\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T>;\n/** Преобразует значения на границе backend, сохраняя его пространство ключей. */\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T> {\n  requireStore(store);\n  if (\n    !isObjectLike(codec) ||\n    typeof codec.encode !== 'function' ||\n    typeof codec.decode !== 'function'\n  ) {\n    throw new ItdConfigError('codec должен содержать функции encode и decode');\n  }\n  const encoded: KeyValueStore<T> = {\n    async get(key) {\n      const value = await store.get(key);\n      return value === undefined ? undefined : codec.decode(value);\n    },\n    async set(key, value) {\n      await store.set(key, await codec.encode(value));\n    },\n    delete: (key) => store.delete(key),\n  };\n  if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);\n  return encoded;\n}\n\n/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */\nfunction emptyRecord<T>(): Record<string, T> {\n  return Object.create(null) as Record<string, T>;\n}\n\nfunction copyRecord<T>(record: Readonly<Record<string, T>> | undefined): Record<string, T> {\n  const copy = emptyRecord<T>();\n  for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;\n  return copy;\n}\n\n/**\n * Создаёт key-value backend поверх одной общей записи.\n *\n * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится\n * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов\n * требуют внешней синхронизации со стороны source.\n */\nexport function createRecordKeyValueStore<T>(\n  source: RecordKeyValueStoreSource<T>,\n): EnumerableKeyValueStore<T> {\n  if (\n    !isObjectLike(source) ||\n    typeof source.read !== 'function' ||\n    typeof source.write !== 'function'\n  ) {\n    throw new ItdConfigError('RecordKeyValueStoreSource должен содержать read и write');\n  }\n  if (source.delete !== undefined && typeof source.delete !== 'function') {\n    throw new ItdConfigError('RecordKeyValueStoreSource.delete должен быть функцией');\n  }\n\n  let committed: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writes: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (committed !== undefined) return committed;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        committed = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return committed;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  /**\n   * Записывает изменение и фиксирует его только после подтверждения source.\n   *\n   * Черновик строится внутри очереди записей, от текущего зафиксированного состояния.\n   *\n   * @param apply вносит изменение в черновик; `false` — менять нечего\n   */\n  const mutate = (apply: (draft: Record<string, T>) => boolean): Promise<void> => {\n    const run = async (): Promise<void> => {\n      const draft = copyRecord(await load());\n      if (!apply(draft)) return;\n\n      if (source.delete && Object.keys(draft).length === 0) await source.delete();\n      else await source.write(draft);\n      committed = draft;\n    };\n    writes = writes.then(run, run);\n    return writes;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    set(key, value) {\n      return mutate((draft) => {\n        draft[key] = value;\n        return true;\n      });\n    },\n    delete(key) {\n      return mutate((draft) => {\n        if (!Object.hasOwn(draft, key)) return false;\n        delete draft[key];\n        return true;\n      });\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/{key-value-store-Bt2PSMxY.js → key-value-store-w1Dn5Pjb.js}

@@ -1,11 +1,8 @@
-import { a as ItdConfigError } from "./errors-GI10kZxk.js";
+import { l as ItdConfigError, n as isRecord, t as isObjectLike } from "./validate-D7_kq3g5.js";
 //#region src/core/key-value-store.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function requireStore(value) {
 	const store = value;
-	if (!isRecord(store)) throw new ItdConfigError("KeyValueStore должен быть объектом");
+	if (!isObjectLike(store)) throw new ItdConfigError("KeyValueStore должен быть объектом");
 	for (const method of [
 		"get",
 		"set",
@@ -70,7 +67,7 @@ function withNamespace(store, namespace, separator = ":") {
 /** Преобразует значения на границе backend, сохраняя его пространство ключей. */
 function withCodec(store, codec) {
 	requireStore(store);
-	if (!isRecord(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new ItdConfigError("codec должен содержать функции encode и decode");
+	if (!isObjectLike(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new ItdConfigError("codec должен содержать функции encode и decode");
 	const encoded = {
 		async get(key) {
 			const value = await store.get(key);
@@ -101,7 +98,7 @@ function copyRecord(record) {
 * требуют внешней синхронизации со стороны source.
 */
 function createRecordKeyValueStore(source) {
-	if (!isRecord(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
+	if (!isObjectLike(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
 	if (source.delete !== void 0 && typeof source.delete !== "function") throw new ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
 	let committed;
 	let loading;
@@ -162,4 +159,4 @@ function createRecordKeyValueStore(source) {
 //#endregion
 export { isEnumerableKeyValueStore as a, createRecordKeyValueStore as i, collectKeyValueStoreKeys as n, withCodec as o, createKeyValueStore as r, withNamespace as s, MemoryKeyValueStore as t };
 
-//# sourceMappingURL=key-value-store-Bt2PSMxY.js.map
+//# sourceMappingURL=key-value-store-w1Dn5Pjb.js.map

package/dist/shared/key-value-store-w1Dn5Pjb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-store-w1Dn5Pjb.js","names":["#values"],"sources":["../../src/core/key-value-store.ts"],"sourcesContent":["import { ItdConfigError } from './errors.js';\nimport { isObjectLike, isRecord } from './validate.js';\n\n/** Синхронный или асинхронный результат операции хранилища. */\nexport type KeyValueStoreResult<T> = T | Promise<T>;\n\n/** Синхронный или асинхронный источник ключей. */\nexport type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;\n\n/**\n * Минимальный backend именованных значений.\n *\n * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение\n * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.\n */\nexport interface KeyValueStore<T> {\n  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */\n  get(key: string): KeyValueStoreResult<T | undefined>;\n  /** Полностью заменяет значение ключа. */\n  set(key: string, value: T): KeyValueStoreResult<void>;\n  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */\n  delete(key: string): KeyValueStoreResult<void>;\n  /** Перечисляет ключи, при возможности ограничивая их префиксом. */\n  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Backend, который гарантированно умеет перечислять ключи. */\nexport interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {\n  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Кодирует значения для хранения в backend другого типа. */\nexport interface KeyValueCodec<T, Stored> {\n  /** Преобразует доменное значение перед записью. */\n  encode(value: T): KeyValueStoreResult<Stored>;\n  /** Восстанавливает доменное значение после чтения. */\n  decode(value: Stored): KeyValueStoreResult<T>;\n}\n\n/** Источник одной записи, содержащей всю карту key-value. */\nexport interface RecordKeyValueStoreSource<T> {\n  /** Читает всю карту. `undefined` означает отсутствие записи. */\n  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;\n  /** Записывает стабильный снимок всей карты. */\n  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;\n  /** Удаляет запись, когда карта становится пустой. */\n  delete?(): KeyValueStoreResult<void>;\n}\n\nfunction requireStore(value: unknown): asserts value is KeyValueStore<unknown> {\n  const store = value as KeyValueStore<unknown>;\n  if (!isObjectLike(store)) throw new ItdConfigError('KeyValueStore должен быть объектом');\n  for (const method of ['get', 'set', 'delete'] as const) {\n    if (typeof store[method] !== 'function') {\n      throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);\n    }\n  }\n  if (store.keys !== undefined && typeof store.keys !== 'function') {\n    throw new ItdConfigError('KeyValueStore.keys должен быть функцией');\n  }\n}\n\nexport function createKeyValueStore<T>(\n  handlers: EnumerableKeyValueStore<T>,\n): EnumerableKeyValueStore<T>;\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;\n/** Собирает {@link KeyValueStore} из функций конкретного backend. */\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T> {\n  requireStore(handlers);\n  return handlers;\n}\n\n/** Проверяет доступность перечисления ключей. */\nexport function isEnumerableKeyValueStore<T>(\n  store: KeyValueStore<T>,\n): store is EnumerableKeyValueStore<T> {\n  return typeof store.keys === 'function';\n}\n\n/** @internal */\nexport async function collectKeyValueStoreKeys<T>(\n  store: EnumerableKeyValueStore<T>,\n  prefix?: string,\n): Promise<string[]> {\n  const source = await store.keys(prefix);\n  const result: string[] = [];\n  for await (const key of source) {\n    if (typeof key !== 'string') {\n      throw new ItdConfigError('KeyValueStore.keys() должен возвращать только строки');\n    }\n    if (prefix === undefined || key.startsWith(prefix)) result.push(key);\n  }\n  return result;\n}\n\n/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */\nexport class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {\n  readonly #values = new Map<string, T>();\n\n  constructor(initial?: Iterable<readonly [string, T]>) {\n    for (const [key, value] of initial ?? []) this.#values.set(key, value);\n  }\n\n  get(key: string): T | undefined {\n    return this.#values.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#values.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#values.delete(key);\n  }\n\n  keys(prefix = ''): string[] {\n    return [...this.#values.keys()].filter((key) => key.startsWith(prefix));\n  }\n}\n\nexport function withNamespace<T>(\n  store: EnumerableKeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): EnumerableKeyValueStore<T>;\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): KeyValueStore<T>;\n/** Добавляет namespace ко всем ключам, не меняя исходный backend. */\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator = ':',\n): KeyValueStore<T> {\n  requireStore(store);\n  if (typeof namespace !== 'string' || typeof separator !== 'string') {\n    throw new ItdConfigError('namespace и separator KeyValueStore должны быть строками');\n  }\n  const base = namespace.length === 0 ? '' : `${namespace}${separator}`;\n  const key = (value: string) => `${base}${value}`;\n  const namespaced: KeyValueStore<T> = {\n    get: (value) => store.get(key(value)),\n    set: (value, data) => store.set(key(value), data),\n    delete: (value) => store.delete(key(value)),\n  };\n\n  if (isEnumerableKeyValueStore(store)) {\n    namespaced.keys = async (prefix = '') => {\n      const keys = await collectKeyValueStoreKeys(store, key(prefix));\n      return keys.map((value) => value.slice(base.length));\n    };\n  }\n  return namespaced;\n}\n\nexport function withCodec<T, Stored>(\n  store: EnumerableKeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): EnumerableKeyValueStore<T>;\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T>;\n/** Преобразует значения на границе backend, сохраняя его пространство ключей. */\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T> {\n  requireStore(store);\n  if (\n    !isObjectLike(codec) ||\n    typeof codec.encode !== 'function' ||\n    typeof codec.decode !== 'function'\n  ) {\n    throw new ItdConfigError('codec должен содержать функции encode и decode');\n  }\n  const encoded: KeyValueStore<T> = {\n    async get(key) {\n      const value = await store.get(key);\n      return value === undefined ? undefined : codec.decode(value);\n    },\n    async set(key, value) {\n      await store.set(key, await codec.encode(value));\n    },\n    delete: (key) => store.delete(key),\n  };\n  if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);\n  return encoded;\n}\n\n/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */\nfunction emptyRecord<T>(): Record<string, T> {\n  return Object.create(null) as Record<string, T>;\n}\n\nfunction copyRecord<T>(record: Readonly<Record<string, T>> | undefined): Record<string, T> {\n  const copy = emptyRecord<T>();\n  for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;\n  return copy;\n}\n\n/**\n * Создаёт key-value backend поверх одной общей записи.\n *\n * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится\n * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов\n * требуют внешней синхронизации со стороны source.\n */\nexport function createRecordKeyValueStore<T>(\n  source: RecordKeyValueStoreSource<T>,\n): EnumerableKeyValueStore<T> {\n  if (\n    !isObjectLike(source) ||\n    typeof source.read !== 'function' ||\n    typeof source.write !== 'function'\n  ) {\n    throw new ItdConfigError('RecordKeyValueStoreSource должен содержать read и write');\n  }\n  if (source.delete !== undefined && typeof source.delete !== 'function') {\n    throw new ItdConfigError('RecordKeyValueStoreSource.delete должен быть функцией');\n  }\n\n  let committed: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writes: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (committed !== undefined) return committed;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        committed = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return committed;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  /**\n   * Записывает изменение и фиксирует его только после подтверждения source.\n   *\n   * Черновик строится внутри очереди записей, от текущего зафиксированного состояния.\n   *\n   * @param apply вносит изменение в черновик; `false` — менять нечего\n   */\n  const mutate = (apply: (draft: Record<string, T>) => boolean): Promise<void> => {\n    const run = async (): Promise<void> => {\n      const draft = copyRecord(await load());\n      if (!apply(draft)) return;\n\n      if (source.delete && Object.keys(draft).length === 0) await source.delete();\n      else await source.write(draft);\n      committed = draft;\n    };\n    writes = writes.then(run, run);\n    return writes;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    set(key, value) {\n      return mutate((draft) => {\n        draft[key] = value;\n        return true;\n      });\n    },\n    delete(key) {\n      return mutate((draft) => {\n        if (!Object.hasOwn(draft, key)) return false;\n        delete draft[key];\n        return true;\n      });\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/shared/{multi-storage-C3Ngtop1.js → multi-storage-BLBrGN9Q.js}

@@ -1,7 +1,7 @@
-import { a as ItdConfigError } from "./errors-GI10kZxk.js";
-import { o as AUTH_FLAG_COOKIE, s as CookieJar } from "./redact-DJV0XM3n.js";
-import { a as isEnumerableKeyValueStore, n as collectKeyValueStoreKeys, r as createKeyValueStore, t as MemoryKeyValueStore } from "./key-value-store-Bt2PSMxY.js";
-import { n as copySession } from "./storage-DiDe0PZM.js";
+import { l as ItdConfigError } from "./validate-D7_kq3g5.js";
+import { D as fallbackLogger, o as AUTH_FLAG_COOKIE, s as CookieJar } from "./redact-C5oxIvcc.js";
+import { a as isEnumerableKeyValueStore, n as collectKeyValueStoreKeys, r as createKeyValueStore, t as MemoryKeyValueStore } from "./key-value-store-w1Dn5Pjb.js";
+import { n as copySession } from "./storage-86wiHeXD.js";
 //#region src/session/multi-storage.ts
 /**
 * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
@@ -93,7 +93,7 @@ function readAccountName(encoded) {
 	try {
 		return decodeURIComponent(encoded);
 	} catch {
-		console.warn(`[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`);
+		fallbackLogger.warn(`запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`);
 		return;
 	}
 }
@@ -124,4 +124,4 @@ function createMultiTokenStorage(store, options = {}) {
 //#endregion
 export { scopedTokenStorage as a, isRestorableSession as i, controlledTokenStorage as n, createMultiTokenStorage as r, MemoryMultiTokenStorage as t };
 
-//# sourceMappingURL=multi-storage-C3Ngtop1.js.map
+//# sourceMappingURL=multi-storage-BLBrGN9Q.js.map

package/dist/shared/multi-storage-BLBrGN9Q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-storage-BLBrGN9Q.js","names":["#store"],"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 { fallbackLogger } from '../core/logger.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: unknown, baseUrl: string): session is ItdSession {\n  if (typeof session !== 'object' || session === null || Array.isArray(session)) return false;\n  const accessToken = (session as { accessToken?: unknown }).accessToken;\n  const refreshToken = (session as { refreshToken?: unknown }).refreshToken;\n  if (typeof accessToken === 'string' && accessToken.trim() !== '') return true;\n  if (typeof refreshToken === 'string' && refreshToken.trim() !== '') return true;\n\n  const cookies = (session as { cookies?: unknown }).cookies;\n  if (!Array.isArray(cookies)) return false;\n\n  const jar = new CookieJar();\n  jar.deserialize(cookies.filter((entry): entry is string => typeof entry === 'string'));\n  return jar.has(AUTH_FLAG_COOKIE, baseUrl);\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    fallbackLogger.warn(\n      `запись хранилища пропущена: ключ ${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/{multi-storage-s-fPtjoy.cjs → multi-storage-C7-Gz6Z7.cjs}

@@ -1,7 +1,7 @@
-const require_errors = require("./errors-BmP3TKoW.cjs");
-const require_redact = require("./redact-lAmck1Z6.cjs");
-const require_key_value_store = require("./key-value-store-B5GYVEYZ.cjs");
-const require_storage = require("./storage-CZJZoaz9.cjs");
+const require_validate = require("./validate-CFx2dISs.cjs");
+const require_redact = require("./redact-DoC7lSsp.cjs");
+const require_key_value_store = require("./key-value-store-DYSPsqwq.cjs");
+const require_storage = require("./storage-CIjejZDt.cjs");
 //#region src/session/multi-storage.ts
 /**
 * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
@@ -93,7 +93,7 @@ function readAccountName(encoded) {
 	try {
 		return decodeURIComponent(encoded);
 	} catch {
-		console.warn(`[itd-api] запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`);
+		require_redact.fallbackLogger.warn(`запись хранилища пропущена: ключ ${JSON.stringify(encoded)} не декодируется`);
 		return;
 	}
 }
@@ -105,9 +105,9 @@ function readAccountName(encoded) {
 */
 function createMultiTokenStorage(store, options = {}) {
 	const prefix = options.prefix ?? ACCOUNT_KEY_PREFIX;
-	if (typeof prefix !== "string") throw new require_errors.ItdConfigError("prefix MultiTokenStorage должен быть строкой");
+	if (typeof prefix !== "string") throw new require_validate.ItdConfigError("prefix MultiTokenStorage должен быть строкой");
 	const backend = require_key_value_store.createKeyValueStore(store);
-	if (!require_key_value_store.isEnumerableKeyValueStore(backend)) throw new require_errors.ItdConfigError("MultiTokenStorage требует KeyValueStore с методом keys()");
+	if (!require_key_value_store.isEnumerableKeyValueStore(backend)) throw new require_validate.ItdConfigError("MultiTokenStorage требует KeyValueStore с методом keys()");
 	const key = (account) => `${prefix}${encodeURIComponent(account)}`;
 	return {
 		async get(account) {
@@ -153,4 +153,4 @@ Object.defineProperty(exports, "scopedTokenStorage", {
 	}
 });
 
-//# sourceMappingURL=multi-storage-s-fPtjoy.cjs.map
+//# sourceMappingURL=multi-storage-C7-Gz6Z7.cjs.map

package/dist/shared/multi-storage-C7-Gz6Z7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-storage-C7-Gz6Z7.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 { fallbackLogger } from '../core/logger.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: unknown, baseUrl: string): session is ItdSession {\n  if (typeof session !== 'object' || session === null || Array.isArray(session)) return false;\n  const accessToken = (session as { accessToken?: unknown }).accessToken;\n  const refreshToken = (session as { refreshToken?: unknown }).refreshToken;\n  if (typeof accessToken === 'string' && accessToken.trim() !== '') return true;\n  if (typeof refreshToken === 'string' && refreshToken.trim() !== '') return true;\n\n  const cookies = (session as { cookies?: unknown }).cookies;\n  if (!Array.isArray(cookies)) return false;\n\n  const jar = new CookieJar();\n  jar.deserialize(cookies.filter((entry): entry is string => typeof entry === 'string'));\n  return jar.has(AUTH_FLAG_COOKIE, baseUrl);\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    fallbackLogger.warn(\n      `запись хранилища пропущена: ключ ${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-DjEtbVaf.cjs → options-5tywTYId.cjs}

@@ -1,5 +1,5 @@
-const require_errors = require("./errors-BmP3TKoW.cjs");
-const require_redact = require("./redact-lAmck1Z6.cjs");
+const require_validate = require("./validate-CFx2dISs.cjs");
+const require_redact = require("./redact-DoC7lSsp.cjs");
 //#region src/core/attachments/contracts.ts
 /** Способ передачи содержимого вложения. */
 const FileTransferMode = Object.freeze({
@@ -15,15 +15,15 @@ const DEFAULT_URL_FILE_MAX_BYTES = 104857600;
 /** Проверяет числовую границу до обращения к источнику. */
 function optionalBytes(value, name) {
 	if (value === void 0) return void 0;
-	if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) throw new require_errors.ItdConfigError(`${name} должен быть неотрицательным целым числом, получено: ${value}`);
+	if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) throw new require_validate.ItdConfigError(`${name} должен быть неотрицательным целым числом, получено: ${value}`);
 	return value;
 }
 /** Создаёт типизированную ошибку превышения размера вложения. */
 function fileTooLarge(url, limit, actual) {
 	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,
+	return new require_validate.ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {
+		reason: require_validate.ItdFileErrorReason.TooLarge,
 		...safeUrl ? { url: safeUrl } : {},
 		limit,
 		actual
@@ -49,7 +49,7 @@ function isReadableByteStream(value) {
 function boundedFileStream(source, options = {}) {
 	const maxBytes = optionalBytes(options.maxBytes, "maxBytes");
 	const streamBufferBytes = optionalBytes(options.streamBufferBytes ?? 4194304, "streamBufferBytes") ?? 4194304;
-	if (streamBufferBytes === 0) throw new require_errors.ItdConfigError("streamBufferBytes должен быть больше нуля");
+	if (streamBufferBytes === 0) throw new require_validate.ItdConfigError("streamBufferBytes должен быть больше нуля");
 	const reader = source.getReader();
 	let total = 0;
 	let finished = false;
@@ -94,12 +94,12 @@ function boundedFileStream(source, options = {}) {
 			} catch (error) {
 				finished = true;
 				cleanup();
-				if (error instanceof require_errors.ItdFileError) {
+				if (error instanceof require_validate.ItdFileError) {
 					controller.error(error);
 					return;
 				}
-				controller.error(new require_errors.ItdFileError("не удалось прочитать поток вложения", {
-					reason: require_errors.ItdFileErrorReason.Read,
+				controller.error(new require_validate.ItdFileError("не удалось прочитать поток вложения", {
+					reason: require_validate.ItdFileErrorReason.Read,
 					...options.url ? { url: require_redact.redactUrl(options.url) } : {},
 					retryable: options.retryableRead ?? false,
 					cause: require_redact.redactErrorCause(error)
@@ -127,11 +127,11 @@ function isBoundedFileStream(stream) {
 /** Проверяет и дополняет настройки потока. @internal */
 function resolveFileStreamOptions(options, defaultMaxBytes) {
 	const mode = options.mode ?? FileTransferMode.Buffer;
-	if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) throw new require_errors.ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);
-	if (mode === FileTransferMode.Stream && typeof ReadableStream === "undefined") throw new require_errors.ItdConfigError("эта среда не поддерживает ReadableStream; используйте mode: 'buffer'");
+	if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) throw new require_validate.ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);
+	if (mode === FileTransferMode.Stream && typeof ReadableStream === "undefined") throw new require_validate.ItdConfigError("эта среда не поддерживает ReadableStream; используйте mode: 'buffer'");
 	const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, "maxBytes");
 	const streamBufferBytes = optionalBytes(options.streamBufferBytes ?? 4194304, "streamBufferBytes") ?? 4194304;
-	if (streamBufferBytes === 0) throw new require_errors.ItdConfigError("streamBufferBytes должен быть больше нуля");
+	if (streamBufferBytes === 0) throw new require_validate.ItdConfigError("streamBufferBytes должен быть больше нуля");
 	return {
 		mode,
 		maxBytes,
@@ -188,4 +188,4 @@ Object.defineProperty(exports, "resolveFileStreamOptions", {
 	}
 });
 
-//# sourceMappingURL=options-DjEtbVaf.cjs.map
+//# sourceMappingURL=options-5tywTYId.cjs.map

package/dist/shared/{options-DjEtbVaf.cjs.map → options-5tywTYId.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"options-DjEtbVaf.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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"}
+{"version":3,"file":"options-5tywTYId.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/{options-i4LrKfqx.js → options-BerKicCs.js}

@@ -1,5 +1,5 @@
-import { a as ItdConfigError, l as ItdFileError, u as ItdFileErrorReason } from "./errors-GI10kZxk.js";
-import { a as redactUrl, r as redactErrorCause } from "./redact-DJV0XM3n.js";
+import { l as ItdConfigError, m as ItdFileErrorReason, p as ItdFileError } from "./validate-D7_kq3g5.js";
+import { a as redactUrl, r as redactErrorCause } from "./redact-C5oxIvcc.js";
 //#region src/core/attachments/contracts.ts
 /** Способ передачи содержимого вложения. */
 const FileTransferMode = Object.freeze({
@@ -141,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-i4LrKfqx.js.map
+//# sourceMappingURL=options-BerKicCs.js.map

package/dist/shared/{options-i4LrKfqx.js.map → options-BerKicCs.js.map}

@@ -1 +1 @@
-{"version":3,"file":"options-i4LrKfqx.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":"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"}
+{"version":3,"file":"options-BerKicCs.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":"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"}