Function validateZipUrl

src/utils/zipValidation.ts:28–74

(
  url: string,
  options: ZipUrlValidationOptions = {}
)

 * Validate an archive URL by checking its size with a HEAD request.
 */
export async function validateZipUrl(
  url: string,
  options: ZipUrlValidationOptions = {}
): Promise<ZipValidationResult> {
  const fetchImpl = options.fetchImpl ?? fetch;
  const sizeLimit = options.sizeLimit ?? ARCHIVE_SIZE_LIMIT;
  const timeoutMs = options.timeoutMs ?? SIZE_CHECK_TIMEOUT;
  const controller = new AbortController();
  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);

  try {
    const response = await fetchImpl(url, {
      method: 'HEAD',
      signal: controller.signal,
    });

    clearTimeout(timeoutId);

    if (!response.ok) {
      return {
        valid: false,
        error: `Failed to access archive (${response.status})`,
      };
    }

    const contentLength = response.headers.get('content-length');
    if (!contentLength) {
      return { valid: true };
    }

    const size = parseSafeIntegerString(contentLength);
    if (size === null) {
      return { valid: true };
    }

    return validateArchiveSize(size, sizeLimit);
  } catch (err) {
    clearTimeout(timeoutId);

    if (err instanceof Error && err.name === 'AbortError') {
      return { valid: false, error: 'Size check timed out' };
    }

    // On HEAD failure (CORS, etc.), allow the download attempt.
    return { valid: true };
  }
}

/**
 * Validate a local archive file by checking its size.