Function loadZipFromUrl

src/utils/zipLoader.ts:203–242

(
  url: string,
  onProgress: (progress: ZipProgress) => void
)

 * Downloads the ZIP, extracts COLMAP files immediately, and builds an index for lazy image extraction.
 */
export async function loadZipFromUrl(
  url: string,
  onProgress: (progress: ZipProgress) => void
): Promise<ZipLoadResult> {
  // Initialize libarchive.js
  await initializeArchive();

  onProgress({ percent: 0, message: 'Checking archive...' });

  // Validate size
  const validation = await validateZipUrl(url);
  if (!validation.valid) {
    throw new Error(validation.error ?? 'Invalid archive');
  }

  // Download archive
  const blob = await downloadZip(url, onProgress);

  // Validate downloaded size
  validateDownloadedArchiveSize(blob, ARCHIVE_SIZE_LIMIT);

  onProgress({ percent: 40, message: 'Opening archive...' });

  // Preserve original filename so libarchive.js can sniff format from extension.
  const archiveName = getFilenameFromUrl(url) || 'archive.zip';
  const file = new File([blob], archiveName);
  const archive = await Archive.open(file);

  // Process archive
  const { colmapFiles, imageIndex, imageCount } = await processZipArchive(archive, onProgress);

  // Verify we have required COLMAP files
  if (!hasRequiredColmapArchiveFiles(colmapFiles.keys())) {
    throw new Error(
      'Archive does not contain valid COLMAP files (cameras.bin, images.bin, points3D.bin)'
    );
  }

  return { colmapFiles, imageIndex, archive, fileSize: blob.size, imageCount };
}

/**
 * Load a ZIP file from a local File object.