Function downloadZip

src/utils/zipDownload.ts:30–56

(
  url: string,
  onProgress: ZipProgressCallback,
  options: ZipDownloadOptions = {}
)

 * Download an archive file from URL with progress tracking.
 */
export async function downloadZip(
  url: string,
  onProgress: ZipProgressCallback,
  options: ZipDownloadOptions = {}
): Promise<Blob> {
  const fetchImpl = options.fetchImpl ?? fetchWithTimeout;
  const timeoutMs = options.timeoutMs ?? DOWNLOAD_TIMEOUT;

  onProgress({ percent: 2, message: 'Starting download...' });

  const response = await fetchImpl(url, timeoutMs);

  if (!response.ok) {
    throw new Error(`Failed to download archive (${response.status})`);
  }

  const contentLength = response.headers.get('content-length');
  const total = contentLength ? parseSafeIntegerString(contentLength) ?? 0 : 0;

  if (!response.body) {
    return response.blob();
  }

  const blob = await readStreamingResponseBlob(response.body, total, onProgress);
  validateDownloadedArchiveSize(blob, options.sizeLimit);
  return blob;
}

/**
 * Validate downloaded archive size after streaming or fallback blob creation.