Release v5 modernization with Active Storage service and multi-config support

- Align uploadcare-rails with uploadcare-ruby v5 APIs and signatures\n- Add migration guide and update README/changelog for v5 release\n- Introduce ActiveStorage::Service::UploadcareService and specs\n- Add optional per-call config support plus mount/job wiring for multi-config use\n- Update CI matrix and Gemfiles for modern Rails/Ruby targets\n- Point uploadcare-ruby git dependency to branch v2-rewrite-2 for CI resolution

Author: vipulnsward

.github/workflows/gem-push.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Release Gem
         if: contains(github.ref, 'refs/tags/v')

.github/workflows/test.yml

@@ -3,18 +3,31 @@ on: [push, pull_request]
 jobs:
   test:
     needs: code-analysis
+    continue-on-error: ${{ matrix.experimental }}
     strategy:
       matrix:
-        gemfile:
-          - Gemfile
-          - gemfiles/Gemfile-rails-7-2
-          - gemfiles/Gemfile-rails-7-1
-          - gemfiles/Gemfile-rails-7-0
-        ruby:
-          - 3.0
-          - 3.1
-          - 3.2
-          - 3.3
+        include:
+          - gemfile: Gemfile
+            ruby: "3.3"
+            experimental: false
+          - gemfile: Gemfile
+            ruby: "3.4"
+            experimental: false
+          - gemfile: gemfiles/Gemfile-rails-8-0
+            ruby: "3.4"
+            experimental: false
+          - gemfile: gemfiles/Gemfile-rails-7-2
+            ruby: "3.4"
+            experimental: false
+          - gemfile: gemfiles/Gemfile-rails-7-1
+            ruby: "3.3"
+            experimental: false
+          - gemfile: gemfiles/Gemfile-rails-7-0
+            ruby: "3.3"
+            experimental: false
+          - gemfile: gemfiles/Gemfile-rails-main
+            ruby: "3.4"
+            experimental: true
     runs-on: ubuntu-latest
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
@@ -33,7 +46,7 @@ jobs:
     strategy:
       matrix:
         ruby-version:
-          - 3.3
+          - "3.4"
     steps:
     - uses: actions/checkout@v4
     - name: Set up Ruby

CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
 The format is based now on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## 5.0.0 — 2026-02-21
+
+### Breaking Changes
+
+* Align wrapper APIs with `uploadcare-ruby` 5.x classes and method signatures.
+* Raise minimum Ruby version to `3.3+`.
+* Change wrapper return contracts to use native SDK objects/results instead of legacy hash/monad expectations.
+* Update configuration bridge from `Uploadcare.config` to `Uploadcare.configuration`.
+
+### Changed
+
+* Modernized REST/Upload API wrappers to use v5 keyword argument signatures.
+* Updated Add-Ons method wiring to v5 method names and request argument format.
+* Updated object wrappers (`Uploadcare::Rails::File`, `Uploadcare::Rails::Group`) for v5 resource base classes.
+* Updated specs to assert v5-native behavior.
+* Added optional per-call `config:` support across API wrappers for multi-config usage in one process.
+* Added initial `ActiveStorage::Service::UploadcareService` adapter.
+
 ## 3.4.4 — 2024-11-07
 
 ### Added

Gemfile

@@ -5,6 +5,13 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in uploadcare-rails.gemspec
 gemspec
 
+local_uploadcare_ruby = File.expand_path('../uploadcare-ruby', __dir__)
+if File.directory?(local_uploadcare_ruby)
+  gem 'uploadcare-ruby', path: local_uploadcare_ruby
+else
+  gem 'uploadcare-ruby', github: 'uploadcare/uploadcare-ruby', branch: 'v2-rewrite-2'
+end
+
 gem 'http-parser', '~> 1.2', '>= 1.2.3'
 gem 'rake', '~> 13.0.6'
 

MIGRATING_V5.md

@@ -0,0 +1,68 @@
+# Migrating to uploadcare-rails 5.0
+
+This guide covers migration from `uploadcare-rails` 3.x/4.x to 5.0.
+
+`uploadcare-rails` 5.0 is aligned with the rewritten `uploadcare-ruby` 5.x API.
+
+## Breaking changes
+
+### Ruby version
+
+- Minimum supported Ruby is now `3.3+`.
+
+### Dependency baseline
+
+- `uploadcare-ruby` 5.x is now required.
+
+### Configuration bridge
+
+The Rails wrapper now writes credentials to `Uploadcare.configuration` (v5 API), not `Uploadcare.config`.
+
+```ruby
+# v4 style (old)
+Uploadcare.config.public_key
+
+# v5 style (new)
+Uploadcare.configuration.public_key
+```
+
+### REST wrapper return types are now native SDK objects
+
+Methods in `Uploadcare::*Api` wrappers now return `uploadcare-ruby` v5 objects/results directly.
+
+- `Uploadcare::FileApi.get_files` -> `Uploadcare::PaginatedCollection`
+- `Uploadcare::FileApi.get_file` -> `Uploadcare::File`
+- `Uploadcare::FileApi.store_file` -> `Uploadcare::File`
+- `Uploadcare::FileApi.delete_file` -> `Uploadcare::File`
+- `Uploadcare::FileApi.store_files` -> `Uploadcare::BatchFileResult`
+- `Uploadcare::FileApi.delete_files` -> `Uploadcare::BatchFileResult`
+- `Uploadcare::GroupApi.get_groups` -> `Uploadcare::PaginatedCollection`
+- `Uploadcare::GroupApi.get_group` -> `Uploadcare::Group`
+- `Uploadcare::GroupApi.store_group` -> `Uploadcare::Group`
+- `Uploadcare::GroupApi.create_group` -> `Uploadcare::Group`
+- `Uploadcare::ProjectApi.get_project` -> `Uploadcare::Project`
+- `Uploadcare::WebhookApi.get_webhooks` -> `Array<Uploadcare::Webhook>`
+- `Uploadcare::WebhookApi.create_webhook` -> `Uploadcare::Webhook`
+- `Uploadcare::WebhookApi.update_webhook` -> `Uploadcare::Webhook`
+
+`Uploadcare::WebhookApi.delete_webhook` returns the direct SDK response payload.
+
+### Conversion API return contract
+
+`Uploadcare::ConversionApi` no longer uses `dry-monads` style `Success(...)`/`Failure(...)` wrappers.
+It now returns direct v5 SDK values:
+
+- `convert_video` -> `Uploadcare::VideoConverter`
+- `get_video_conversion_status` -> `Uploadcare::VideoConverter`
+- `convert_document` -> `Hash`
+- `get_document_conversion_status` -> `Uploadcare::DocumentConverter`
+- `get_document_conversion_formats_info` -> `Uploadcare::DocumentConverter`
+
+## Migration checklist
+
+1. Upgrade Ruby to `3.3+`.
+2. Upgrade to `uploadcare-rails` 5.x.
+3. Replace any `Uploadcare.config` usage with `Uploadcare.configuration`.
+4. Update integrations that expected Hash/monad responses from wrapper APIs.
+5. Run your full application and test suite.
+