Upload Product Images

curl -X POST "https://api.devdraft.ai/api/v0/products/550e8400-e29b-41d4-a716-446655440000/images" \
  -H "x-client-key: YOUR_CLIENT_KEY" \
  -H "x-client-secret: YOUR_CLIENT_SECRET" \
  -H "x-idempotency-key: $(uuidgen)" \
  -F "images=@/path/to/product-image.jpg"

{
  "statusCode": 400,
  "message": "Invalid image upload request",
  "error": "Bad Request",
  "details": {
    "invalidFiles": [
      {
        "filename": "invalid.txt",
        "reason": "Unsupported file type"
      },
      {
        "filename": "too-large.jpg",
        "reason": "File size exceeds 10MB limit"
      }
    ],
    "validFiles": 2,
    "totalFiles": 4
  }
}

// Organize images by purpose
const imageStrategy = {
  primary: 'main-product-shot.jpg',        // Hero image
  details: 'product-details.jpg',          // Close-up features
  lifestyle: 'product-in-use.jpg',         // Usage context
  packaging: 'product-packaging.jpg',      // Box/packaging
  variants: 'product-colors.jpg'           // Different options
};

// Upload in priority order
const priorityOrder = [
  imageStrategy.primary,
  imageStrategy.details,
  imageStrategy.lifestyle,
  imageStrategy.packaging,
  imageStrategy.variants
];

// Pre-validate before upload
const validateBeforeUpload = async (files) => {
  const validation = await imageManager.validateImages(files);
  
  if (!validation.allValid) {
    throw new Error(`Invalid files: ${validation.invalidFiles.join(', ')}`);
  }
  
  return validation.validFiles;
};

// Optimize for web
const optimizeForWeb = async (files) => {
  return await Promise.all(
    files.map(file => imageManager.optimizeImageQuality(file, 1200, 0.8))
  );
};

// Progressive upload
const progressiveUpload = async (productId, files) => {
  // Upload primary image first
  await imageManager.uploadImages(productId, [files[0]], { replaceAll: true });
  
  // Upload remaining images in background
  if (files.length > 1) {
    setTimeout(() => {
      imageManager.uploadImages(productId, files.slice(1));
    }, 1000);
  }
};

// Upload with progress tracking
const uploadWithProgress = async (productId, files, onProgress) => {
  const total = files.length;
  let completed = 0;
  
  const batchSize = 3;
  const batches = [];
  
  for (let i = 0; i < files.length; i += batchSize) {
    batches.push(files.slice(i, i + batchSize));
  }
  
  const results = [];
  
  for (const batch of batches) {
    try {
      const result = await imageManager.uploadImages(productId, batch);
      results.push(result);
      completed += batch.length;
      
      onProgress({
        completed,
        total,
        percentage: Math.round((completed / total) * 100),
        currentBatch: results.length,
        totalBatches: batches.length
      });
    } catch (error) {
      results.push({ error: error.message });
    }
  }
  
  return results;
};

// Organize product images by category
const organizeProductImages = async (productId, imageCategories) => {
  const uploads = [];
  
  // Upload main images first
  if (imageCategories.main) {
    uploads.push(
      imageManager.uploadImages(productId, imageCategories.main, { 
        replaceAll: true,
        position: 0 
      })
    );
  }
  
  // Add detail images
  if (imageCategories.details) {
    uploads.push(
      imageManager.uploadImages(productId, imageCategories.details, { 
        position: imageCategories.main?.length || 0 
      })
    );
  }
  
  // Add lifestyle images
  if (imageCategories.lifestyle) {
    uploads.push(
      imageManager.uploadImages(productId, imageCategories.lifestyle, { 
        position: (imageCategories.main?.length || 0) + (imageCategories.details?.length || 0)
      })
    );
  }
  
  return await Promise.all(uploads);
};