feat!: Add multi-provider architecture with Cloudinary integration and unified interface

[csarigoz]

🚀 Multi-Provider Architecture - Major Refactor

📋 Description

This PR introduces a major breaking change that transforms the project from a CloudFront-only image upload utility into a comprehensive Multi-Provider Image Upload Utility supporting both Cloudinary and CloudFront/S3 providers through a unified interface.

Version Impact: This will be released as v2.0.0 after merge due to breaking changes in architecture.

🔗 Related Issues

• Addresses need for easier setup alternative to CloudFront
• Implements provider abstraction for future extensibility
• Resolves test failures and integration issues

🎯 Type of Change

• 💥 Breaking change (new provider architecture)
• ✨ New feature (Cloudinary integration)
• ♻️ Code refactoring (provider factory pattern)
• 📚 Documentation update (comprehensive docs overhaul)
• 🧪 Adding tests (Cloudinary integration tests)
• 🔧 Build/CI changes (multi-provider testing)

[... rest of the PR description remains the same ...]

📋 Post-Merge Actions Required

After this PR is merged, the maintainer should:

1. Update version to 2.0.0:

   git checkout main
   git pull origin main
   
   # Update CHANGELOG.md: [Unreleased] → [2.0.0] - 2025-01-30
   # Tag the release
   git add CHANGELOG.md
   git commit -m "chore: bump version to 2.0.0"
   git tag -a v2.0.0 -m "Release version 2.0.0 - Multi-Provider Architecture"
   git push origin main --tags

2. Create GitHub Release with release notes from CHANGELOG.md

3. Update documentation links if deployment URLs change

✅ Final Checklist

• All tests passing (python test_cloudinary.py)
• Pre-commit checks passing (minor linting warnings are false positives)
• Documentation updated and comprehensive
• Backward compatibility maintained
• CI/CD pipeline updated
• Environment setup documented
• Breaking changes clearly documented
• Provider isolation verified
• Performance testing completed
• Uses [Unreleased] in CHANGELOG (version will be set after merge)
• Versioning strategy documented in PROJECT_RULES.md

🎉 Ready for Review

This PR represents a major milestone in the project's evolution, transforming it from a single-provider utility into a flexible, extensible, multi-provider image optimization platform. The architecture is designed for easy addition of future providers while maintaining full backward compatibility.

Reviewers should focus on:

• Provider abstraction implementation
• Environment variable handling
• Documentation completeness
• Backward compatibility verification
• Versioning strategy adherence