Function fetchZipMask

src/utils/zipImageFiles.ts:98–135

(imageName: string)

 * Extract a mask from ZIP.
 */
export async function fetchZipMask(imageName: string): Promise<File | null> {
  const cached = zipMaskState.getCached(imageName);
  if (cached) return cached;

  if (!hasActiveZipArchive()) return null;

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

  const imageIndex = getActiveZipImageIndex();
  if (!imageIndex) return null;

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

  try {
    for (const maskPath of getMaskPathVariants(imageName)) {
      const entry = findZipEntry(maskPath, imageIndex);
      if (entry) {
        try {
          const file = await entry.extract();
          zipMaskState.setCached(imageName, file);
          result = file;
          appLogger.info(`[ZIP Mask] Found mask for ${imageName}`);
          return file;
        } catch (err) {
          appLogger.debug(`[ZIP Mask] Error extracting ${maskPath}:`, err);
        }
      }
    }

    appLogger.debug(`[ZIP Mask] No mask found for ${imageName}`);
    return null;
  } finally {
    zipMaskState.completeRequest(imageName, result);
  }
}

/**
 * Remove specific entries from the ZIP mask cache.