Function fetchUrlImage

src/utils/urlImageFiles.ts:92–135

(
  imageUrlBase: string | null,
  imageName: string,
  explicitUrl?: string
)

 * @returns The fetched File or null if fetch failed
 */
export async function fetchUrlImage(
  imageUrlBase: string | null,
  imageName: string,
  explicitUrl?: string
): Promise<File | null> {
  const cached = urlImageState.getCached(imageName);
  if (cached) {
    return cached;
  }

  const resolved = resolveImageRequestUrl(imageUrlBase, imageName, explicitUrl);
  if (!resolved) {
    return null;
  }
  const { url: imageUrl, filename } = resolved;

  if (urlImageState.isRequestPending(imageUrl)) {
    return urlImageState.waitForRequest(imageUrl);
  }

  urlImageState.startRequest(imageUrl);
  let result: File | null = null;

  try {
    const response = await fetch(imageUrl);
    if (!response.ok) {
      appLogger.warn(`[URL Image] Failed to fetch ${imageName}: ${response.status}`);
      return null;
    }

    const blob = await response.blob();
    const file = await compressAndResizeToJpeg(blob, filename);

    urlImageState.setCached(imageName, file);
    result = file;

    return file;
  } catch (err) {
    appLogger.warn(`[URL Image] Error fetching ${imageName}:`, err);
    return null;
  } finally {
    urlImageState.completeRequest(imageUrl, result);
  }
}

/**
 * Fetch an image from URL without display-cache resizing or JPEG recompression.