itd-api 0.6.0 → 0.7.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-Dg5N3r1V.cjs","names":["ItdConfigError","ItdFileError","ItdFileErrorReason","ItdConfigError","ItdFileError","ItdFileErrorReason","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';\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 source = url ? ` по адресу ${url}` : '';\n  return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {\n    reason: ItdFileErrorReason.TooLarge,\n    ...(url ? { url } : {}),\n    limit,\n    actual,\n  });\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.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: options.url } : {}),\n              retryable: options.retryableRead ?? false,\n              cause: error,\n            }),\n          );\n        }\n      },\n      async cancel(reason) {\n        finished = true;\n        cleanup();\n        await reader.cancel(reason).catch(() => {});\n      },\n    },\n    {\n      highWaterMark: streamBufferBytes,\n      size: (chunk) => chunk.byteLength,\n    },\n  );\n  BOUNDED_FILE_STREAMS.add(stream);\n  return stream;\n}\n\n/** Наложены ли на поток ограничения библиотеки. @internal */\nexport function isBoundedFileStream(stream: ReadableStream<Uint8Array>): boolean {\n  return BOUNDED_FILE_STREAMS.has(stream);\n}\n","import { ItdConfigError } from '../errors.js';\nimport {\n  DEFAULT_FILE_STREAM_BUFFER_BYTES,\n  type FileStreamOptions,\n  FileTransferMode,\n} from './contracts.js';\nimport { optionalBytes } from './limits.js';\n\n/** Проверяет и дополняет настройки потока. @internal */\nexport function resolveFileStreamOptions(\n  options: FileStreamOptions,\n  defaultMaxBytes?: number,\n): {\n  mode: FileTransferMode;\n  maxBytes: number | undefined;\n  streamBufferBytes: number;\n} {\n  const mode = options.mode ?? FileTransferMode.Buffer;\n  if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) {\n    throw new ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);\n  }\n  if (mode === FileTransferMode.Stream && typeof ReadableStream === 'undefined') {\n    throw new ItdConfigError(\n      \"эта среда не поддерживает ReadableStream; используйте mode: 'buffer'\",\n    );\n  }\n\n  const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, 'maxBytes');\n  const streamBufferBytes =\n    optionalBytes(\n      options.streamBufferBytes ?? DEFAULT_FILE_STREAM_BUFFER_BYTES,\n      'streamBufferBytes',\n    ) ?? DEFAULT_FILE_STREAM_BUFFER_BYTES;\n  if (streamBufferBytes === 0) {\n    throw new ItdConfigError('streamBufferBytes должен быть больше нуля');\n  }\n\n  return { mode, maxBytes, streamBufferBytes };\n}\n"],"mappings":";;;AACA,MAAa,mBAAmB,OAAO,OAAO;;CAE5C,QAAQ;;CAER,QAAQ;AACV,CAAU;;AAOV,MAAa,6BAA6B;;;;ACV1C,SAAgB,cAAc,OAA2B,MAAkC;CACzF,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;CAChC,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,CAAC,OAAO,UAAU,KAAK,GACjE,MAAM,IAAIA,eAAAA,eACR,GAAG,KAAK,uDAAuD,OACjE;CAEF,OAAO;AACT;;AAGA,SAAgB,aAAa,KAAyB,OAAe,QAA8B;CACjG,MAAM,SAAS,MAAM,cAAc,QAAQ;CAC3C,OAAO,IAAIC,eAAAA,aAAa,OAAO,OAAO,oBAAoB,MAAM,SAAS,UAAU;EACjF,QAAQC,eAAAA,mBAAmB;EAC3B,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;EACrB;EACA;CACF,CAAC;AACH;;;;ACjBA,MAAM,uCAAuB,IAAI,QAAoC;;AAYrE,SAAS,QAAQ,OAA+B;CAC9C,OAAO,iBAAiB,aAAa,QAAQ,IAAI,WAAW,KAAK;AACnE;;AAGA,SAAgB,qBAAqB,OAAqD;CACxF,OAAO,OAAO,mBAAmB,eAAe,iBAAiB;AACnE;;;;;;AAOA,SAAgB,kBACd,QACA,UAAoC,CAAC,GACT;CAC5B,MAAM,WAAW,cAAc,QAAQ,UAAU,UAAU;CAC3D,MAAM,oBACJ,cACE,QAAQ,qBAAA,SACR,mBACF,KAAA;CACF,IAAI,sBAAsB,GACxB,MAAM,IAAIC,eAAAA,eAAe,2CAA2C;CAGtE,MAAM,SAAS,OAAO,UAAU;CAChC,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI;CAEJ,MAAM,gBAAgB;EACpB,IAAI,eAAe,QAAQ,QAAQ,oBAAoB,SAAS,aAAa;EAC7E,gBAAgB,KAAA;CAClB;CAEA,MAAM,SAAS,IAAI,eACjB;EACE,MAAM,YAAY;GAChB,IAAI,CAAC,QAAQ,QAAQ;GACrB,sBAAsB;IACpB,WAAW;IACX,OAAY,OAAO,QAAQ,QAAQ,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACzD,WAAW,MAAM,QAAQ,QAAQ,UAAU,IAAI,aAAa,WAAW,YAAY,CAAC;IACpF,QAAQ;GACV;GACA,IAAI,QAAQ,OAAO,SAAS,cAAc;QACrC,QAAQ,OAAO,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;EAC7E;EACA,MAAM,KAAK,YAAY;GACrB,IAAI,UAAU;GAEd,IAAI;IACF,MAAM,OAAO,MAAM,OAAO,KAAK;IAC/B,IAAI,UAAU;IACd,IAAI,KAAK,MAAM;KACb,WAAW;KACX,QAAQ;KACR,WAAW,MAAM;KACjB;IACF;IAEA,MAAM,QAAQ,QAAQ,KAAK,KAAK;IAChC,SAAS,MAAM;IACf,IAAI,aAAa,KAAA,KAAa,QAAQ,UAAU;KAC9C,WAAW;KACX,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;KACpC,QAAQ;KACR,WAAW,MAAM,aAAa,QAAQ,KAAK,UAAU,KAAK,CAAC;KAC3D;IACF;IAEA,WAAW,QAAQ,KAAK;GAC1B,SAAS,OAAO;IACd,WAAW;IACX,QAAQ;IACR,IAAI,iBAAiBC,eAAAA,cAAc;KACjC,WAAW,MAAM,KAAK;KACtB;IACF;IACA,WAAW,MACT,IAAIA,eAAAA,aAAa,uCAAuC;KACtD,QAAQC,eAAAA,mBAAmB;KAC3B,GAAI,QAAQ,MAAM,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC;KAC1C,WAAW,QAAQ,iBAAiB;KACpC,OAAO;IACT,CAAC,CACH;GACF;EACF;EACA,MAAM,OAAO,QAAQ;GACnB,WAAW;GACX,QAAQ;GACR,MAAM,OAAO,OAAO,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;EAC5C;CACF,GACA;EACE,eAAe;EACf,OAAO,UAAU,MAAM;CACzB,CACF;CACA,qBAAqB,IAAI,MAAM;CAC/B,OAAO;AACT;;AAGA,SAAgB,oBAAoB,QAA6C;CAC/E,OAAO,qBAAqB,IAAI,MAAM;AACxC;;;;ACtHA,SAAgB,yBACd,SACA,iBAKA;CACA,MAAM,OAAO,QAAQ,QAAQ,iBAAiB;CAC9C,IAAI,SAAS,iBAAiB,UAAU,SAAS,iBAAiB,QAChE,MAAM,IAAIC,eAAAA,eAAe,8DAA8D,MAAM;CAE/F,IAAI,SAAS,iBAAiB,UAAU,OAAO,mBAAmB,aAChE,MAAM,IAAIA,eAAAA,eACR,sEACF;CAGF,MAAM,WAAW,cAAc,QAAQ,YAAY,iBAAiB,UAAU;CAC9E,MAAM,oBACJ,cACE,QAAQ,qBAAA,SACR,mBACF,KAAA;CACF,IAAI,sBAAsB,GACxB,MAAM,IAAIA,eAAAA,eAAe,2CAA2C;CAGtE,OAAO;EAAE;EAAM;EAAU;CAAkB;AAC7C"}

package/dist/shared/options-DtATYdLr.js

@@ -0,0 +1,142 @@
+import { a as ItdConfigError, l as ItdFileError, u as ItdFileErrorReason } from "./errors-Bhrd2fJd.js";
+//#region src/core/attachments/contracts.ts
+/** Способ передачи содержимого вложения. */
+const FileTransferMode = Object.freeze({
+	/** Сначала получить файл целиком, затем отправить его как `Blob`. */
+	Buffer: "buffer",
+	/** Передавать данные по мере чтения, не собирая файл целиком в памяти. */
+	Stream: "stream"
+});
+/** Предел размера файла, скачиваемого по адресу, — 100 МиБ. */
+const DEFAULT_URL_FILE_MAX_BYTES = 104857600;
+//#endregion
+//#region src/core/attachments/limits.ts
+/** Проверяет числовую границу до обращения к источнику. */
+function optionalBytes(value, name) {
+	if (value === void 0) return void 0;
+	if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value)) throw new ItdConfigError(`${name} должен быть неотрицательным целым числом, получено: ${value}`);
+	return value;
+}
+/** Создаёт типизированную ошибку превышения размера вложения. */
+function fileTooLarge(url, limit, actual) {
+	const source = url ? ` по адресу ${url}` : "";
+	return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {
+		reason: ItdFileErrorReason.TooLarge,
+		...url ? { url } : {},
+		limit,
+		actual
+	});
+}
+//#endregion
+//#region src/core/attachments/bounded-stream.ts
+/** Потоки, на которые уже наложены счётчик размера и backpressure. */
+const BOUNDED_FILE_STREAMS = /* @__PURE__ */ new WeakSet();
+/** Приводит произвольный чанк потока к байтам. */
+function asBytes(value) {
+	return value instanceof Uint8Array ? value : new Uint8Array(value);
+}
+/** Проверяет значение без обращения к методам потенциально чужого объекта. */
+function isReadableByteStream(value) {
+	return typeof ReadableStream !== "undefined" && value instanceof ReadableStream;
+}
+/**
+* Ограничивает размер и очередь потока. Отмена результирующего потока отменяет исходный.
+*
+* @internal
+*/
+function boundedFileStream(source, options = {}) {
+	const maxBytes = optionalBytes(options.maxBytes, "maxBytes");
+	const streamBufferBytes = optionalBytes(options.streamBufferBytes ?? 4194304, "streamBufferBytes") ?? 4194304;
+	if (streamBufferBytes === 0) throw new ItdConfigError("streamBufferBytes должен быть больше нуля");
+	const reader = source.getReader();
+	let total = 0;
+	let finished = false;
+	let abortListener;
+	const cleanup = () => {
+		if (abortListener) options.signal?.removeEventListener("abort", abortListener);
+		abortListener = void 0;
+	};
+	const stream = new ReadableStream({
+		start(controller) {
+			if (!options.signal) return;
+			abortListener = () => {
+				finished = true;
+				reader.cancel(options.signal?.reason).catch(() => {});
+				controller.error(options.signal?.reason ?? new DOMException("Aborted", "AbortError"));
+				cleanup();
+			};
+			if (options.signal.aborted) abortListener();
+			else options.signal.addEventListener("abort", abortListener, { once: true });
+		},
+		async pull(controller) {
+			if (finished) return;
+			try {
+				const next = await reader.read();
+				if (finished) return;
+				if (next.done) {
+					finished = true;
+					cleanup();
+					controller.close();
+					return;
+				}
+				const chunk = asBytes(next.value);
+				total += chunk.byteLength;
+				if (maxBytes !== void 0 && total > maxBytes) {
+					finished = true;
+					await reader.cancel().catch(() => {});
+					cleanup();
+					controller.error(fileTooLarge(options.url, maxBytes, total));
+					return;
+				}
+				controller.enqueue(chunk);
+			} catch (error) {
+				finished = true;
+				cleanup();
+				if (error instanceof ItdFileError) {
+					controller.error(error);
+					return;
+				}
+				controller.error(new ItdFileError("не удалось прочитать поток вложения", {
+					reason: ItdFileErrorReason.Read,
+					...options.url ? { url: options.url } : {},
+					retryable: options.retryableRead ?? false,
+					cause: error
+				}));
+			}
+		},
+		async cancel(reason) {
+			finished = true;
+			cleanup();
+			await reader.cancel(reason).catch(() => {});
+		}
+	}, {
+		highWaterMark: streamBufferBytes,
+		size: (chunk) => chunk.byteLength
+	});
+	BOUNDED_FILE_STREAMS.add(stream);
+	return stream;
+}
+/** Наложены ли на поток ограничения библиотеки. @internal */
+function isBoundedFileStream(stream) {
+	return BOUNDED_FILE_STREAMS.has(stream);
+}
+//#endregion
+//#region src/core/attachments/options.ts
+/** Проверяет и дополняет настройки потока. @internal */
+function resolveFileStreamOptions(options, defaultMaxBytes) {
+	const mode = options.mode ?? FileTransferMode.Buffer;
+	if (mode !== FileTransferMode.Buffer && mode !== FileTransferMode.Stream) throw new ItdConfigError(`mode вложения должен быть 'buffer' или 'stream', получено: ${mode}`);
+	if (mode === FileTransferMode.Stream && typeof ReadableStream === "undefined") throw new ItdConfigError("эта среда не поддерживает ReadableStream; используйте mode: 'buffer'");
+	const maxBytes = optionalBytes(options.maxBytes ?? defaultMaxBytes, "maxBytes");
+	const streamBufferBytes = optionalBytes(options.streamBufferBytes ?? 4194304, "streamBufferBytes") ?? 4194304;
+	if (streamBufferBytes === 0) throw new ItdConfigError("streamBufferBytes должен быть больше нуля");
+	return {
+		mode,
+		maxBytes,
+		streamBufferBytes
+	};
+}
+//#endregion
+export { fileTooLarge as a, FileTransferMode as c, isReadableByteStream as i, boundedFileStream as n, optionalBytes as o, isBoundedFileStream as r, DEFAULT_URL_FILE_MAX_BYTES as s, resolveFileStreamOptions as t };
+
+//# sourceMappingURL=options-DtATYdLr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-DtATYdLr.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';\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 source = url ? ` по адресу ${url}` : '';\n  return new ItdFileError(`файл${source} больше предела в ${limit} байт: ${actual}`, {\n    reason: ItdFileErrorReason.TooLarge,\n    ...(url ? { url } : {}),\n    limit,\n    actual,\n  });\n}\n","import { ItdConfigError, ItdFileError, ItdFileErrorReason } from '../errors.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: options.url } : {}),\n              retryable: options.retryableRead ?? false,\n              cause: 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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"}