Function fetchZipImage

src/utils/zipImageFiles.ts:47–78

(imageName: string)

 * Returns the cached File if already extracted, otherwise extracts and caches.
 */
export async function fetchZipImage(imageName: string): Promise<File | null> {
  const cached = zipImageState.getCached(imageName);
  if (cached) return cached;

  if (!hasActiveZipArchive()) return null;

  if (zipImageState.isRequestPending(imageName)) {
    return zipImageState.waitForRequest(imageName);
  }

  zipImageState.startRequest(imageName);
  let result: File | null = null;

  try {
    const extractedFile = await extractZipImage(imageName);
    if (!extractedFile) {
      return null;
    }

    const filename = imageName.split('/').pop() || imageName;
    const file = await compressAndResizeToJpeg(new Blob([await extractedFile.arrayBuffer()]), filename);
    zipImageState.setCached(imageName, file);
    result = file;

    return file;
  } catch (err) {
    appLogger.warn(`[ZIP Image] Error extracting ${imageName}:`, err);
    return null;
  } finally {
    zipImageState.completeRequest(imageName, result);
  }
}

/**
 * Extract an image from ZIP without display-cache resizing or JPEG recompression.