Function processImageFile

cli/src/utils/image-handler.ts:187–286

(
  filePath: string,
  cwd: string,
)

 * Includes automatic downsampling for large images.
 */
export async function processImageFile(
  filePath: string,
  cwd: string,
): Promise<ImageUploadResult> {
  const resolvedPath = resolveFilePath(filePath, cwd)

  // Validate file exists
  let stats
  try {
    stats = statSync(resolvedPath)
  } catch (error) {
    logger.debug({ resolvedPath, error }, 'Image handler: File not found')
    return { success: false, error: `File not found: ${filePath}` }
  }

  if (!stats.isFile()) {
    return { success: false, error: `Path is not a file: ${filePath}` }
  }

  // Validate file size
  if (stats.size > MAX_IMAGE_FILE_SIZE) {
    const sizeMB = (stats.size / (1024 * 1024)).toFixed(1)
    const maxMB = (MAX_IMAGE_FILE_SIZE / (1024 * 1024)).toFixed(1)
    return { success: false, error: `File too large: ${sizeMB}MB (max ${maxMB}MB): ${filePath}` }
  }

  // Validate image format
  if (!isImageFile(resolvedPath)) {
    return {
      success: false,
      error: `Unsupported image format: ${filePath}. Supported: ${Array.from(SUPPORTED_IMAGE_EXTENSIONS).join(', ')}`,
    }
  }

  // Get MIME type
  const mediaType = getImageMimeType(path.extname(resolvedPath))
  if (!mediaType) {
    return { success: false, error: `Could not determine image type for: ${filePath}` }
  }

  // Read file
  let fileBuffer: Buffer
  try {
    fileBuffer = readFileSync(resolvedPath)
  } catch (error) {
    logger.debug({ resolvedPath, error }, 'Image handler: Failed to read file')
    return { success: false, error: `Could not read file: ${filePath}` }
  }

  // Get initial dimensions
  let width: number | undefined
  let height: number | undefined
  try {
    const image = await Jimp.read(fileBuffer)
    width = image.bitmap.width
    height = image.bitmap.height
  } catch {
    // Continue without dimensions if we can't read them