@rockhall/electron-offline-content 0.4.0

package/dist/main/asset-download.js

@@ -0,0 +1,263 @@
+import { StorageLimitError, SyncFailureError, isNoSpaceError } from "../shared/errors.js";
+import { createWriteStream, existsSync, mkdirSync, readdirSync, renameSync, rmSync, statSync } from "node:fs";
+import { unlink } from "node:fs/promises";
+import { Readable } from "node:stream";
+import { dirname, join } from "node:path";
+import { pipeline } from "node:stream/promises";
+//#region src/main/asset-download.ts
+/** When `reserveFreeBytes` is omitted, preserve this much free space on the cache volume (1 GiB). */
+const DEFAULT_RESERVE_FREE_BYTES = 1024 * 1024 * 1024;
+/**
+* Effective minimum free bytes: explicit option, or {@link DEFAULT_RESERVE_FREE_BYTES} when omitted.
+* `0` means no reserved headroom.
+* @internal
+*/
+function effectiveReserveFreeBytes(explicit) {
+	return explicit === void 0 ? DEFAULT_RESERVE_FREE_BYTES : explicit;
+}
+var AssetDownloader = class {
+	storageRoot;
+	deps;
+	options;
+	constructor(storageRoot, deps, options) {
+		this.storageRoot = storageRoot;
+		this.deps = deps;
+		this.options = options;
+	}
+	remainingDownloadBytes(download) {
+		const expectedBytes = download.byteLength ?? 0;
+		const partialBytes = this.partialDownloadBytes(download);
+		return Math.max(expectedBytes - partialBytes, 0);
+	}
+	partialDownloadPath(download) {
+		return join(this.storageRoot, "temp", sanitizeSegment(download.assetKey), sanitizeSegment(download.version), `${sanitizeSegment(download.fileName)}.part`);
+	}
+	cleanupObsoletePartialDownloads(downloads) {
+		const tempRoot = join(this.storageRoot, "temp");
+		if (!existsSync(tempRoot)) return;
+		const resumablePaths = new Set(downloads.map((download) => this.partialDownloadPath(download)));
+		for (const filePath of listFilesRecursively(tempRoot)) {
+			if (!filePath.endsWith(".part") || resumablePaths.has(filePath)) continue;
+			rmSync(filePath, { force: true });
+			pruneEmptyParents(filePath, this.storageRoot);
+		}
+	}
+	async downloadAsset(download, onChunk) {
+		const destinationRelativePath = join("blobs", sanitizeSegment(download.assetKey), sanitizeSegment(download.version), sanitizeSegment(download.fileName));
+		const destinationPath = join(this.storageRoot, destinationRelativePath);
+		mkdirSync(dirname(destinationPath), { recursive: true });
+		const tempPath = this.partialDownloadPath(download);
+		mkdirSync(dirname(tempPath), { recursive: true });
+		let lastError = null;
+		for (let attempt = 0; attempt < TOTAL_DOWNLOAD_ATTEMPTS; attempt += 1) try {
+			return await this.downloadAssetAttempt(download, destinationPath, destinationRelativePath, tempPath, onChunk);
+		} catch (error) {
+			lastError = error;
+			if (isNoSpaceError(error)) {
+				await unlink(tempPath).catch(() => void 0);
+				this.options.emitLog("error", "asset_download_storage_failed", {
+					asset_key: download.assetKey,
+					url: download.request.url
+				});
+				throw new StorageLimitError(`Disk is full while downloading ${download.assetKey}.`, { cause: error });
+			}
+			if (!isRetryableDownloadError(error)) {
+				await unlink(tempPath).catch(() => void 0);
+				throw error;
+			}
+			if (attempt === TOTAL_DOWNLOAD_ATTEMPTS - 1) {
+				this.options.emitLog("warn", "asset_download_retry_exhausted", {
+					asset_key: download.assetKey,
+					attempt: attempt + 1,
+					partial_path: tempPath
+				});
+				break;
+			}
+			const delayMs = calculateRetryDelay(attempt);
+			this.options.emitLog("warn", "asset_download_retry_scheduled", {
+				asset_key: download.assetKey,
+				attempt: attempt + 1,
+				retry_delay_ms: delayMs
+			});
+			await this.deps.sleep(delayMs);
+		}
+		throw lastError;
+	}
+	async ensureFileSpaceCommit() {
+		const stats = await this.deps.statfs(this.storageRoot);
+		const availableBytes = Number(stats.bavail) * Number(stats.bsize);
+		const reserve = effectiveReserveFreeBytes(this.options.reserveFreeBytes);
+		if (availableBytes < reserve) throw new StorageLimitError(`Committing download would violate reserveFreeBytes ${reserve}.`);
+	}
+	partialDownloadBytes(download) {
+		const tempPath = this.partialDownloadPath(download);
+		return existsSync(tempPath) ? statSync(tempPath).size : 0;
+	}
+	async downloadAssetAttempt(download, destinationPath, destinationRelativePath, tempPath, onChunk) {
+		let restartedWithoutRange = false;
+		for (;;) {
+			const resumeSize = existsSync(tempPath) ? statSync(tempPath).size : 0;
+			const headers = new Headers(download.request.headers);
+			if (resumeSize > 0) headers.set("range", `bytes=${resumeSize}-`);
+			const response = await this.deps.fetchImpl(download.request.url, {
+				method: download.request.method ?? "GET",
+				headers
+			});
+			if (resumeSize > 0 && response.status === 416) {
+				if (restartedWithoutRange) throw createDownloadError(`Server rejected range request for ${download.assetKey}.`, false, response.status);
+				restartedWithoutRange = true;
+				await unlink(tempPath).catch(() => void 0);
+				this.options.emitLog("debug", "asset_download_range_restart", {
+					asset_key: download.assetKey,
+					resumed_bytes: resumeSize,
+					response_status: response.status,
+					content_range: response.headers.get("content-range")
+				});
+				continue;
+			}
+			if (!response.ok || !response.body) {
+				this.options.emitLog("warn", "asset_download_rejected", {
+					asset_key: download.assetKey,
+					status: response.status,
+					status_text: response.statusText,
+					url: download.request.url
+				});
+				throw createDownloadError(`Download failed for ${download.assetKey}: ${response.status} ${response.statusText}`, isRetryableStatus(response.status), response.status);
+			}
+			if (resumeSize > 0 && (response.status !== 206 || parseContentRangeStart(response.headers.get("content-range")) !== resumeSize)) {
+				if (restartedWithoutRange) throw createDownloadError(`Server did not honor range request for ${download.assetKey}.`, false, response.status);
+				restartedWithoutRange = true;
+				await unlink(tempPath).catch(() => void 0);
+				this.options.emitLog("debug", "asset_download_range_restart", {
+					asset_key: download.assetKey,
+					resumed_bytes: resumeSize,
+					response_status: response.status,
+					content_range: response.headers.get("content-range")
+				});
+				continue;
+			}
+			const nodeStream = Readable.fromWeb(response.body);
+			const writeStream = createWriteStream(tempPath, { flags: resumeSize > 0 ? "a" : "w" });
+			nodeStream.on("data", (chunk) => {
+				onChunk(chunk.byteLength);
+			});
+			try {
+				await pipeline(nodeStream, writeStream);
+			} catch (error) {
+				throw wrapRetryableDownloadError(error);
+			}
+			await this.ensureFileSpaceCommit();
+			mkdirSync(dirname(destinationPath), { recursive: true });
+			rmSync(destinationPath, { force: true });
+			renameSync(tempPath, destinationPath);
+			return {
+				relativePath: destinationRelativePath,
+				fallbackMimeType: normalizeResponseMimeType(response.headers.get("content-type"))
+			};
+		}
+	}
+};
+function sanitizeSegment(segment) {
+	return encodeURIComponent(segment);
+}
+function pruneEmptyParents(pathToFile, storageRoot) {
+	let current = dirname(pathToFile);
+	while (current.startsWith(storageRoot) && current !== storageRoot) {
+		if (existsSync(current) && readdirSync(current).length === 0) {
+			rmSync(current, {
+				recursive: true,
+				force: true
+			});
+			current = dirname(current);
+			continue;
+		}
+		break;
+	}
+}
+function listFilesRecursively(directory) {
+	if (!existsSync(directory)) return [];
+	if (statSync(directory).isFile()) return [directory];
+	return readdirSync(directory).flatMap((entry) => listFilesRecursively(join(directory, entry)));
+}
+const TOTAL_DOWNLOAD_ATTEMPTS = 4;
+const RETRYABLE_STATUS_CODES = new Set([
+	408,
+	429,
+	500,
+	502,
+	503,
+	504
+]);
+const RETRYABLE_ERROR_CODES = new Set([
+	"ECONNRESET",
+	"ECONNREFUSED",
+	"EHOSTUNREACH",
+	"ENETUNREACH",
+	"ENOTFOUND",
+	"ETIMEDOUT",
+	"UND_ERR_CONNECT_TIMEOUT",
+	"UND_ERR_HEADERS_TIMEOUT",
+	"UND_ERR_SOCKET"
+]);
+function calculateRetryDelay(attempt) {
+	const baseDelay = 1e3 * Math.pow(2, attempt);
+	return baseDelay + Math.floor(baseDelay * .25 * Math.random());
+}
+function createDownloadError(message, retryable, status, cause) {
+	const error = new SyncFailureError(message, cause ? { cause } : void 0);
+	error.retryable = retryable;
+	error.status = status;
+	return error;
+}
+function wrapRetryableDownloadError(error) {
+	if (error instanceof SyncFailureError) return error;
+	if (error instanceof Error) {
+		const wrapped = new SyncFailureError(error.message, { cause: error });
+		wrapped.retryable = hasRetryableDownloadSignal(error);
+		return wrapped;
+	}
+	const wrapped = new SyncFailureError(String(error));
+	wrapped.retryable = false;
+	return wrapped;
+}
+function isRetryableDownloadError(error) {
+	if (!(error instanceof Error)) return false;
+	const candidate = error;
+	if (candidate.retryable !== void 0) return candidate.retryable;
+	return hasRetryableDownloadSignal(error);
+}
+function isRetryableStatus(status) {
+	return RETRYABLE_STATUS_CODES.has(status);
+}
+function isRetryableErrorCode(code) {
+	return code !== void 0 && RETRYABLE_ERROR_CODES.has(code);
+}
+function isRetryableMessage(message) {
+	const value = message.toLowerCase();
+	return value.includes("aborted") || value.includes("connection") || value.includes("network") || value.includes("reset") || value.includes("socket") || value.includes("terminated") || value.includes("timeout");
+}
+function hasRetryableDownloadSignal(error) {
+	return collectErrorChain(error).some((entry) => isRetryableErrorCode(entry.code) || isRetryableMessage(entry.message));
+}
+function collectErrorChain(error) {
+	const chain = [];
+	let current = error;
+	while (current instanceof Error && !chain.includes(current)) {
+		chain.push(current);
+		current = current.cause;
+	}
+	return chain;
+}
+function normalizeResponseMimeType(contentType) {
+	const value = contentType?.trim();
+	return value && value.length > 0 ? value : null;
+}
+function parseContentRangeStart(contentRange) {
+	if (!contentRange) return null;
+	const match = contentRange.match(/^bytes (\d+)-\d+\/(?:\d+|\*)$/i);
+	return match?.[1] ? Number.parseInt(match[1], 10) : null;
+}
+//#endregion
+export { AssetDownloader, DEFAULT_RESERVE_FREE_BYTES, effectiveReserveFreeBytes };
+
+//# sourceMappingURL=asset-download.js.map

package/dist/main/asset-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-download.js","names":[],"sources":["../../src/main/asset-download.ts"],"sourcesContent":["import {\n  createWriteStream,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  renameSync,\n  rmSync,\n  statSync,\n} from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { ReadableStream as NodeReadableStream } from \"node:stream/web\";\nimport { dirname, join } from \"node:path\";\nimport { isNoSpaceError, StorageLimitError, SyncFailureError } from \"../shared/errors.js\";\nimport type { JsonValue, MediaCacheLogLevel } from \"../shared/types.js\";\n\n/** When `reserveFreeBytes` is omitted, preserve this much free space on the cache volume (1 GiB). */\nexport const DEFAULT_RESERVE_FREE_BYTES = 1024 * 1024 * 1024;\n\n/**\n * Effective minimum free bytes: explicit option, or {@link DEFAULT_RESERVE_FREE_BYTES} when omitted.\n * `0` means no reserved headroom.\n * @internal\n */\nexport function effectiveReserveFreeBytes(explicit: number | undefined): number {\n  return explicit === undefined ? DEFAULT_RESERVE_FREE_BYTES : explicit;\n}\n\nexport interface QueuedAssetDownloadTarget {\n  assetKey: string;\n  fileName: string;\n  version: string;\n  byteLength?: number;\n}\n\nexport interface AssetDownloadTarget extends QueuedAssetDownloadTarget {\n  request: {\n    url: string;\n    method?: string;\n    headers?: HeadersInit;\n  };\n}\n\nexport interface AssetDownloadResult {\n  relativePath: string;\n  fallbackMimeType: string | null;\n}\n\nexport interface AssetDownloaderDependencies {\n  fetchImpl: typeof globalThis.fetch;\n  sleep: (delayMs: number) => Promise<void>;\n  statfs: (path: string) => Promise<StatFsResult>;\n}\n\nexport type AssetDownloadLogHandler = (\n  level: MediaCacheLogLevel,\n  event: string,\n  fields?: Record<string, JsonValue | undefined>,\n) => void;\n\ntype StatFsResult = Awaited<ReturnType<typeof import(\"node:fs/promises\").statfs>>;\n\nexport class AssetDownloader {\n  constructor(\n    private readonly storageRoot: string,\n    private readonly deps: AssetDownloaderDependencies,\n    private readonly options: {\n      reserveFreeBytes?: number;\n      emitLog: AssetDownloadLogHandler;\n    },\n  ) {}\n\n  remainingDownloadBytes(download: QueuedAssetDownloadTarget): number {\n    const expectedBytes = download.byteLength ?? 0;\n    const partialBytes = this.partialDownloadBytes(download);\n    return Math.max(expectedBytes - partialBytes, 0);\n  }\n\n  partialDownloadPath(download: QueuedAssetDownloadTarget): string {\n    return join(\n      this.storageRoot,\n      \"temp\",\n      sanitizeSegment(download.assetKey),\n      sanitizeSegment(download.version),\n      `${sanitizeSegment(download.fileName)}.part`,\n    );\n  }\n\n  cleanupObsoletePartialDownloads(downloads: QueuedAssetDownloadTarget[]): void {\n    const tempRoot = join(this.storageRoot, \"temp\");\n    if (!existsSync(tempRoot)) {\n      return;\n    }\n\n    const resumablePaths = new Set(downloads.map((download) => this.partialDownloadPath(download)));\n    for (const filePath of listFilesRecursively(tempRoot)) {\n      if (!filePath.endsWith(\".part\") || resumablePaths.has(filePath)) {\n        continue;\n      }\n\n      rmSync(filePath, { force: true });\n      pruneEmptyParents(filePath, this.storageRoot);\n    }\n  }\n\n  async downloadAsset(\n    download: AssetDownloadTarget,\n    onChunk: (chunkBytes: number) => void,\n  ): Promise<AssetDownloadResult> {\n    const destinationRelativePath = join(\n      \"blobs\",\n      sanitizeSegment(download.assetKey),\n      sanitizeSegment(download.version),\n      sanitizeSegment(download.fileName),\n    );\n    const destinationPath = join(this.storageRoot, destinationRelativePath);\n\n    mkdirSync(dirname(destinationPath), { recursive: true });\n    const tempPath = this.partialDownloadPath(download);\n    mkdirSync(dirname(tempPath), { recursive: true });\n\n    let lastError: unknown = null;\n\n    for (let attempt = 0; attempt < TOTAL_DOWNLOAD_ATTEMPTS; attempt += 1) {\n      try {\n        return await this.downloadAssetAttempt(\n          download,\n          destinationPath,\n          destinationRelativePath,\n          tempPath,\n          onChunk,\n        );\n      } catch (error) {\n        lastError = error;\n\n        if (isNoSpaceError(error)) {\n          await unlink(tempPath).catch(() => undefined);\n          this.options.emitLog(\"error\", \"asset_download_storage_failed\", {\n            asset_key: download.assetKey,\n            url: download.request.url,\n          });\n          throw new StorageLimitError(`Disk is full while downloading ${download.assetKey}.`, {\n            cause: error,\n          });\n        }\n\n        const retryable = isRetryableDownloadError(error);\n        if (!retryable) {\n          await unlink(tempPath).catch(() => undefined);\n          throw error;\n        }\n\n        if (attempt === TOTAL_DOWNLOAD_ATTEMPTS - 1) {\n          this.options.emitLog(\"warn\", \"asset_download_retry_exhausted\", {\n            asset_key: download.assetKey,\n            attempt: attempt + 1,\n            partial_path: tempPath,\n          });\n          break;\n        }\n\n        const delayMs = calculateRetryDelay(attempt);\n        this.options.emitLog(\"warn\", \"asset_download_retry_scheduled\", {\n          asset_key: download.assetKey,\n          attempt: attempt + 1,\n          retry_delay_ms: delayMs,\n        });\n        await this.deps.sleep(delayMs);\n      }\n    }\n\n    throw lastError;\n  }\n\n  async ensureFileSpaceCommit(): Promise<void> {\n    const stats = await this.deps.statfs(this.storageRoot);\n    const availableBytes = Number(stats.bavail) * Number(stats.bsize);\n    const reserve = effectiveReserveFreeBytes(this.options.reserveFreeBytes);\n    if (availableBytes < reserve) {\n      throw new StorageLimitError(`Committing download would violate reserveFreeBytes ${reserve}.`);\n    }\n  }\n\n  private partialDownloadBytes(download: QueuedAssetDownloadTarget): number {\n    const tempPath = this.partialDownloadPath(download);\n    return existsSync(tempPath) ? statSync(tempPath).size : 0;\n  }\n\n  private async downloadAssetAttempt(\n    download: AssetDownloadTarget,\n    destinationPath: string,\n    destinationRelativePath: string,\n    tempPath: string,\n    onChunk: (chunkBytes: number) => void,\n  ): Promise<AssetDownloadResult> {\n    let restartedWithoutRange = false;\n\n    for (;;) {\n      const resumeSize = existsSync(tempPath) ? statSync(tempPath).size : 0;\n      const headers = new Headers(download.request.headers);\n      if (resumeSize > 0) {\n        headers.set(\"range\", `bytes=${resumeSize}-`);\n      }\n\n      const response = await this.deps.fetchImpl(download.request.url, {\n        method: download.request.method ?? \"GET\",\n        headers,\n      });\n\n      if (resumeSize > 0 && response.status === 416) {\n        if (restartedWithoutRange) {\n          throw createDownloadError(\n            `Server rejected range request for ${download.assetKey}.`,\n            false,\n            response.status,\n          );\n        }\n\n        restartedWithoutRange = true;\n        await unlink(tempPath).catch(() => undefined);\n        this.options.emitLog(\"debug\", \"asset_download_range_restart\", {\n          asset_key: download.assetKey,\n          resumed_bytes: resumeSize,\n          response_status: response.status,\n          content_range: response.headers.get(\"content-range\"),\n        });\n        continue;\n      }\n\n      if (!response.ok || !response.body) {\n        this.options.emitLog(\"warn\", \"asset_download_rejected\", {\n          asset_key: download.assetKey,\n          status: response.status,\n          status_text: response.statusText,\n          url: download.request.url,\n        });\n        throw createDownloadError(\n          `Download failed for ${download.assetKey}: ${response.status} ${response.statusText}`,\n          isRetryableStatus(response.status),\n          response.status,\n        );\n      }\n\n      if (\n        resumeSize > 0 &&\n        (response.status !== 206 ||\n          parseContentRangeStart(response.headers.get(\"content-range\")) !== resumeSize)\n      ) {\n        if (restartedWithoutRange) {\n          throw createDownloadError(\n            `Server did not honor range request for ${download.assetKey}.`,\n            false,\n            response.status,\n          );\n        }\n\n        restartedWithoutRange = true;\n        await unlink(tempPath).catch(() => undefined);\n        this.options.emitLog(\"debug\", \"asset_download_range_restart\", {\n          asset_key: download.assetKey,\n          resumed_bytes: resumeSize,\n          response_status: response.status,\n          content_range: response.headers.get(\"content-range\"),\n        });\n        continue;\n      }\n\n      const nodeStream = Readable.fromWeb(\n        response.body as unknown as NodeReadableStream<Uint8Array>,\n      );\n      const writeStream = createWriteStream(tempPath, { flags: resumeSize > 0 ? \"a\" : \"w\" });\n\n      nodeStream.on(\"data\", (chunk) => {\n        onChunk((chunk as Buffer).byteLength);\n      });\n\n      try {\n        await pipeline(nodeStream, writeStream);\n      } catch (error) {\n        throw wrapRetryableDownloadError(error);\n      }\n\n      await this.ensureFileSpaceCommit();\n      mkdirSync(dirname(destinationPath), { recursive: true });\n      rmSync(destinationPath, { force: true });\n      renameSync(tempPath, destinationPath);\n      return {\n        relativePath: destinationRelativePath,\n        fallbackMimeType: normalizeResponseMimeType(response.headers.get(\"content-type\")),\n      };\n    }\n  }\n}\n\nfunction sanitizeSegment(segment: string): string {\n  return encodeURIComponent(segment);\n}\n\nfunction pruneEmptyParents(pathToFile: string, storageRoot: string): void {\n  let current = dirname(pathToFile);\n  while (current.startsWith(storageRoot) && current !== storageRoot) {\n    if (existsSync(current) && readdirSync(current).length === 0) {\n      rmSync(current, { recursive: true, force: true });\n      current = dirname(current);\n      continue;\n    }\n    break;\n  }\n}\n\nfunction listFilesRecursively(directory: string): string[] {\n  if (!existsSync(directory)) {\n    return [];\n  }\n\n  const stats = statSync(directory);\n  if (stats.isFile()) {\n    return [directory];\n  }\n\n  return readdirSync(directory).flatMap((entry) => listFilesRecursively(join(directory, entry)));\n}\n\nconst TOTAL_DOWNLOAD_ATTEMPTS = 4;\nconst RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);\nconst RETRYABLE_ERROR_CODES = new Set([\n  \"ECONNRESET\",\n  \"ECONNREFUSED\",\n  \"EHOSTUNREACH\",\n  \"ENETUNREACH\",\n  \"ENOTFOUND\",\n  \"ETIMEDOUT\",\n  \"UND_ERR_CONNECT_TIMEOUT\",\n  \"UND_ERR_HEADERS_TIMEOUT\",\n  \"UND_ERR_SOCKET\",\n]);\n\ntype RetryableDownloadError = Error & {\n  retryable?: boolean;\n  status?: number;\n};\n\nfunction calculateRetryDelay(attempt: number): number {\n  const baseDelay = 1000 * Math.pow(2, attempt);\n  const jitter = Math.floor(baseDelay * 0.25 * Math.random());\n  return baseDelay + jitter;\n}\n\nfunction createDownloadError(\n  message: string,\n  retryable: boolean,\n  status?: number,\n  cause?: unknown,\n): RetryableDownloadError {\n  const error = new SyncFailureError(\n    message,\n    cause ? { cause } : undefined,\n  ) as RetryableDownloadError;\n  error.retryable = retryable;\n  error.status = status;\n  return error;\n}\n\nfunction wrapRetryableDownloadError(error: unknown): RetryableDownloadError {\n  if (error instanceof SyncFailureError) {\n    return error as RetryableDownloadError;\n  }\n\n  if (error instanceof Error) {\n    const wrapped = new SyncFailureError(error.message, { cause: error }) as RetryableDownloadError;\n    wrapped.retryable = hasRetryableDownloadSignal(error);\n    return wrapped;\n  }\n\n  const wrapped = new SyncFailureError(String(error)) as RetryableDownloadError;\n  wrapped.retryable = false;\n  return wrapped;\n}\n\nfunction isRetryableDownloadError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  const candidate = error as RetryableDownloadError;\n  if (candidate.retryable !== undefined) {\n    return candidate.retryable;\n  }\n\n  return hasRetryableDownloadSignal(error);\n}\n\nfunction isRetryableStatus(status: number): boolean {\n  return RETRYABLE_STATUS_CODES.has(status);\n}\n\nfunction isRetryableErrorCode(code: string | undefined): boolean {\n  return code !== undefined && RETRYABLE_ERROR_CODES.has(code);\n}\n\nfunction isRetryableMessage(message: string): boolean {\n  const value = message.toLowerCase();\n  return (\n    value.includes(\"aborted\") ||\n    value.includes(\"connection\") ||\n    value.includes(\"network\") ||\n    value.includes(\"reset\") ||\n    value.includes(\"socket\") ||\n    value.includes(\"terminated\") ||\n    value.includes(\"timeout\")\n  );\n}\n\nfunction hasRetryableDownloadSignal(error: Error): boolean {\n  return collectErrorChain(error).some(\n    (entry) =>\n      isRetryableErrorCode((entry as NodeJS.ErrnoException).code) ||\n      isRetryableMessage(entry.message),\n  );\n}\n\nfunction collectErrorChain(error: Error): Error[] {\n  const chain: Error[] = [];\n  let current: unknown = error;\n\n  while (current instanceof Error && !chain.includes(current)) {\n    chain.push(current);\n    current = current.cause;\n  }\n\n  return chain;\n}\n\nfunction normalizeResponseMimeType(contentType: string | null): string | null {\n  const value = contentType?.trim();\n  return value && value.length > 0 ? value : null;\n}\n\nfunction parseContentRangeStart(contentRange: string | null): number | null {\n  if (!contentRange) {\n    return null;\n  }\n\n  const match = contentRange.match(/^bytes (\\d+)-\\d+\\/(?:\\d+|\\*)$/i);\n  return match?.[1] ? Number.parseInt(match[1], 10) : null;\n}\n"],"mappings":"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"}