imagekitio 2.0.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db316e0a4525fa5a4f72d3f993da7fdb12480e18957cf40f0a84ec40c255ab2e
-  data.tar.gz: f24d4d783f368bb5ba90807f3dec82f677f943a9ccff4373dd6d56471e524517
+  metadata.gz: aabd0c2da76f3f7008b3315212cc04f81434c6bb372dff4448176cf014db01c9
+  data.tar.gz: a9d42b5d5c729fc600ee01361dc78ee97200518f17bd196498a0ae543623b0b9
 SHA512:
-  metadata.gz: 5cd39012d46c350b0cbaefce9dfe60fc7bdf5e8fd110fc01e05b06fa95c9bff171c679dc0d724cc41ddf1b968ea2f3fef3dd30e867d6f2da1935d0e4cd02afd8
-  data.tar.gz: 360f33ade97be7c1c72e7c6be026008688dfced40b4201ba17d33b180f93270070a77e23718072fb779386f1707abb3c7f1b2ba6ba4ff5102cc03ca4747ad809
+  metadata.gz: e1bdc9b382371fe0620bb4f0f834037d823063ae924c2806cf78f09ffa644308b0f7739484da388a279b48913ab79fe29228b0328c8d4c8c15674e0a293a7d7b
+  data.tar.gz: 5395acd1194c6a218de14e86cc9e60a3bfb06bb048743967c6645f7452cff7b1978a3fa2bbd72cd8508f061ffa08b4947c12b3f986638b04bd7fa4458b32f222

data/README.md

@@ -8,7 +8,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Twitter Follow](https://img.shields.io/twitter/follow/imagekitio?label=Follow&style=social)](https://twitter.com/ImagekitIo)
 
-ImageKit gem for Ruby on Rails that allows you to use real-time [image resizing](https://docs.imagekit.io/features/image-transformations), [optimization](https://docs.imagekit.io/features/image-optimization), and [file uploading](https://docs.imagekit.io/api-reference/upload-file-api/).
+Ruby on Rails gem for [ImageKit](https://imagekit.io/) implements the new APIs and interface for different file operations.
+
+ImageKit is complete media storage, optimization, and transformation solution that comes with an [image and video CDN](https://imagekit.io/features/imagekit-infrastructure). It can be integrated with your existing infrastructure - storage like AWS S3, web servers, your CDN, and custom domain names, allowing you to deliver optimized images in minutes with minimal code changes.
 
 Table of contents -
  * [Installation](#Installation)
@@ -155,20 +157,17 @@ imagekitio:
 
 ## Usage
 
-You can use this Ruby SDK for three different methods - URL generation, file upload, and file management.
+You can use this Ruby SDK for three different methods - URL generation, file upload, and media management operations. The usage of the SDK has been explained below.
 
-The usage of the SDK has been explained below.
+* `URL Generation`
+* `File Upload`
+* `File Management`
 
 ## URL generation
 
 **1. Using Image path and image hostname or endpoint**
 
-This method allows you to create a URL using the path where the image exists and the URL
-endpoint(url_endpoint) you want to use to access the image. You can refer to the documentation
-[here](https://docs.imagekit.io/integration/url-endpoints) to read more about URL endpoints
-in ImageKit and the section about [image origins](https://docs.imagekit.io/integration/configure-origin) to understand
-about paths with different kinds of origins.
-
+This method allows you to create an URL to access a file using the relative file path and the ImageKit URL endpoint (`urlEndpoint`). The file can be an image, video or any other static file supported by ImageKit.
 
 ```ruby
 imagekitio = ImageKitIo.client
@@ -185,8 +184,7 @@ https://ik.imagekit.io/your_imagekit_id/endpoint/tr:h-300,w-400,ar-4-3,q-40/defa
 ```
 
 **2.Using full image URL**
-This method allows you to add transformation parameters to an existing, complete URL already mapped to ImageKit using the `src` parameter. This method should be used if you have the complete image URL mapped to ImageKit stored in your
-database.
+This method allows you to add transformation parameters to an absolute URL. For example, if you have configured a custom CNAME and have absolute asset URLs in your database or CMS, you will often need this.
 
 
 ```ruby
@@ -286,8 +284,7 @@ https://ik.imagekit.io/your_imagekit_id/tr:h-300,w-400/default-image.jpg?v=123&i
 
 **List of transformations**
 
-The complete list of transformations supported and their usage in ImageKit can be found [here](https://docs.imagekit.io/features/image-transformations/resize-crop-and-other-transformations).
-The SDK gives a name to each transformation parameter, making the code simpler, making the code simpler, and readable.
+The complete list of transformations supported and their usage in ImageKit can be found [here](https://docs.imagekit.io/features/image-transformations/resize-crop-and-other-transformations). The SDK gives a name to each transformation parameter, making the code simpler, making the code simpler, and readable.
 
 If a transformation is supported in ImageKit, but a name for it cannot be found in the table below, then use the transformation code from ImageKit docs as the name when using the `url` function.
 
@@ -385,7 +382,7 @@ be `None`.
 The SDK provides a simple interface for all the [media APIs mentioned here](https://docs.imagekit.io/api-reference/media-api)
 to manage your files. This also returns `error` and `result`. The `error` will be `None` if API succeeds.
 
-**1. List & Search Files**
+**List & Search Files**
 
 Accepts an object specifying the parameters to be used to list and search files. All parameters specified
 in the [documentation here](https://docs.imagekit.io/api-reference/media-api/list-and-search-files#list-and-search-file-api) can be passed with the
@@ -397,7 +394,7 @@ imagekitio.list_files(
     limit: 5
 )
 ```
-**2. Get File Details**
+**Get File Details**
 Accepts the file ID and fetches the details as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/get-file-details)
 
 ```ruby
@@ -406,7 +403,7 @@ imagekitio.get_file_details(
 )
 ```
 
-**3. Get File Metadata**
+**Get File Metadata**
 Accepts the file ID and fetches the metadata as per the [API documentation here](https://docs.imagekit.io/api-reference/metadata-api/get-image-metadata-for-uploaded-media-files)
 ```ruby
 imagekit.get_file_metadata(
@@ -414,7 +411,7 @@ imagekit.get_file_metadata(
 )
 ```
 
-**3. Get File Metadata from remote url**
+**Get File Metadata from remote url**
 Accepts the remote file url and fetches the metadata as per the [API documentation here](https://docs.imagekit.io/api-reference/metadata-api/get-image-metadata-from-remote-url)
 
 ```ruby
@@ -423,7 +420,7 @@ imagekit.get_remote_file_url_metadata(
 )
 ```
 
-**4. Update File Details**
+**Update File Details**
 Update parameters associated with the file as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/update-file-details).
 The first argument to the `update_field_details` method is the file ID, and a second argument is an object with the
 parameters to be updated.
@@ -436,18 +433,19 @@ imagekitio.update_file_details(
 )
 ```
 
-**5. Copy File**
+**Copy File**
 
 Copy file from one path to another path using the source file path and the destination path as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/copy-file)
 
 ```ruby
 imagekitio.copy_file(
     source_file_path: '/path/to/file.jpg',
-    destination_path: '/folder/to/copy/into'
+    destination_path: '/folder/to/copy/into',
+    include_file_versions: true #default false
 )
 ```
 
-**6. Move File**
+**Move File**
 
 Move file from one folder to another folder using the source file path and destination path as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/move-file)
 
@@ -458,7 +456,7 @@ imagekitio.move_file(
 )
 ```
 
-**7. Rename File**
+**Rename File**
 
 Rename file as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/rename-file)
 
@@ -470,7 +468,8 @@ imagekitio.rename_file(
 )
 ```
 
-**8. Delete file**
+**Delete File**
+
 Delete a file as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/delete-file). The method accepts the file ID of the file that has to be deleted.
 
 ```ruby
@@ -478,8 +477,50 @@ imagekitio.delete_file(
     file_id: '598821f949c0a938d57563bd'
 )
 ```
+**File versions**
+
+Get all file versions as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/get-file-versions). The method accepts the file ID of the file.
+
+```ruby
+imagekitio.file_versions(
+    file_id: '598821f949c0a938d57563bd'
+)
+```
+**File version details**
+
+Get all file version detail as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/get-file-version-details). The method accepts the file ID and version ID of the file.
+
+```ruby
+imagekitio.file_version_detail(
+    file_id: '598821f949c0a938d57563bd',
+    version_id: '846321f949c0a938d57567ty'
+)
+```
+
+**Delete file version**
+
+Delete file version as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/delete-file-version). The method accepts the file ID and version ID of the file.
+
+```ruby
+imagekitio.delete_file_version(
+    file_id: '598821f949c0a938d57563bd',
+    version_id: '846321f949c0a938d57567ty'
+)
+```
+
+**Restore file version**
+
+Restore deleted file version as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/restore-file-version). The method accepts the file ID and version ID of the file.
+
+```ruby
+imagekitio.restore_file_version(
+    file_id: '598821f949c0a938d57563bd',
+    version_id: '846321f949c0a938d57567ty'
+)
+```
+
+**Bulk File Delete by IDs**
 
-**9. Bulk File Delete by IDs**
 Delete a file as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/delete-files-bulk). The method accepts a list of file IDs of files that has to be
 deleted.
 
@@ -489,7 +530,7 @@ imagekitio.delete_bulk_files(
 )
 ```
 
-**10. Purge Cache**
+**Purge Cache**
 Programmatically issue a clear cache request as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/purge-cache).
 Accepts the full URL of the file for which the cache has to be cleared.
 
@@ -498,7 +539,7 @@ imagekitio.purge_file_cache(
     file_url: 'https://ik.imagekit.io/demo/logo-white_SJwqB4Nfe.png'
 )
 ```
-**11. Purge Cache Status**
+**Purge Cache Status**
 
 Get the purge cache request status using the request ID returned when a purge cache request gets submitted as per the
 [API documentation here](https://docs.imagekit.io/api-reference/media-api/purge-cache-status)
@@ -509,7 +550,7 @@ imagekitio.purge_file_cache_status(
 )
 ```
 
-**12. Add Bulk Tags**
+**Add Bulk Tags**
 
 Add multiple tags on multiple files using an array of file ids and an array of tags as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/add-tags-bulk)
 
@@ -520,7 +561,7 @@ imagekitio.add_bulk_tags(
 )
 ``` 
 
-**13. Delete Bulk Tags**
+**Delete Bulk Tags**
 
 Remove multiple tags from multiple files using an array of file ids and an array of tags as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/remove-tags-bulk)
 
@@ -531,7 +572,7 @@ imagekitio.delete_bulk_tags(
 )
 ```
 
-**14. Delete Bulk Ai Tags**
+**Delete Bulk AI Tags**
 
 Delete bulk ai tags as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/remove-aitags-bulk)
 
@@ -542,7 +583,7 @@ imagekitio.delete_bulk_ai_tags(
 )
 ```
 
-**15. Create Folder**
+**Create Folder**
 
 Create folder as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/create-folder)
 
@@ -554,18 +595,19 @@ imagekitio.create_folder(
 ```
 
 
-**16. Copy Folder**
+**Copy Folder**
 
 Copy folder as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/copy-folder)
 
 ```ruby
 imagekitio.copy_folder(
     source_folder_path: '/folder/to/copy',
-    destination_path: '/folder/to/copy/into'
+    destination_path: '/folder/to/copy/into',
+    include_file_versions: true #default false
 )
 ```
 
-**17. Move Folder**
+**Move Folder**
 
 Move folder as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/move-folder)
 
@@ -576,7 +618,7 @@ imagekitio.move_folder(
 )
 ```
 
-**18. Delete Folder**
+**Delete Folder**
 
 Delete folder as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/delete-folder)
 
@@ -586,7 +628,7 @@ imagekitio.delete_folder(
 )
 ```
 
-**19. Bulk Job Status**
+**Bulk Job Status**
 
 Get the bulk job status as per the [API documentation here](https://docs.imagekit.io/api-reference/media-api/copy-move-folder-status)
 
@@ -596,7 +638,7 @@ imagekitio.bulk_job_status(
 )
 ```
 
-**20. Create Custom Metadata Fields**
+**Create a custom metadata field**
 
 Create custom metadata fields as per the [API documentation here](https://docs.imagekit.io/api-reference/custom-metadata-fields-api/create-custom-metadata-field)
 
@@ -613,7 +655,7 @@ imagekitio.create_custom_metadata_field(
 )
 ```
 
-**21. Get Custom Metadata Fields**
+**Get Custom Metadata Fields**
 
 Get the custom metadata fields as per the [API documentation here](https://docs.imagekit.io/api-reference/custom-metadata-fields-api/get-custom-metadata-field)
 
@@ -623,7 +665,7 @@ imagekitio.get_custom_metadata_fields(
 )
 ```
 
-**22. Update Custom Metadata Fields**
+**Update Custom Metadata Fields**
 
 Update custom metadata fields as per the [API documentation here](https://docs.imagekit.io/api-reference/custom-metadata-fields-api/update-custom-metadata-field)
 
@@ -635,7 +677,7 @@ imagekitio.update_custom_metadata_field(
 )
 ```
 
-**23. Delete Custom Metadata Fields**
+**Delete Custom Metadata Fields**
 
 Delete custom metadata fields as per the [API documentation here](https://docs.imagekit.io/api-reference/custom-metadata-fields-api/delete-custom-metadata-field)
 
@@ -645,6 +687,38 @@ imagekitio.delete_custom_metadata_field(
 )
 ```
 
+## Access request-id, other response headers and HTTP status code
+
+Each media management function returns a hash with `response`, `error`, `status_code`, `headers`, `raw_body` keys with respective values.
+
+```ruby
+upload = imagekitio.upload_file(
+    file: file,
+    file_name:  "default.jpg",
+    folder: '/test',
+    response_fields: 'tags,customCoordinates,isPrivateFile,metadata',
+    tags: %w[abc def],
+    use_unique_file_name: false,
+    is_private_file: true
+)
+puts upload[:status_code] # 200
+puts upload[:headers]
+
+#   {
+#        "access-control-allow-origin"=>["*"],
+#         "x-ik-requestid"=>["6963194e-014f-8945-b05a-bdb0e088f1bd"],
+#         "content-type"=>["application/json; charset=utf-8"],
+#         "content-length"=>["611"],
+#         "etag"=>["W/\"859-GOeZiRFGOZERjHBgRUhG0EGcODs\""],
+#         "date"=>["Wed, 29 Jun 2022 07:04:33 GMT"],
+#         "x-request-id"=>["6963194e-014f-8945-b05a-bdb0e088f1bd"],
+#         "connection"=>["close"]
+#   }
+
+
+puts upload[:raw_body]
+# "{\"fileId\":\"62bjf980rb886bd691b86760\",\"name\":\"default.jpg\",\"size\":102117,\"versionInfo\":{\"id\":\"62bjf980rb886bd691b86760\",\"name\":\"Version 1\"},\"filePath\":\"/test/default.jpg\",\"url\":\"https://ik.imagekit.io/46865sdf6sdf/test/default.jpg\",\"fileType\":\"image\",\"height\":700,\"width\":1050,\"thumbnailUrl\":\"https://ik.imagekit.io/46865sdf6sdf/tr:n-ik_ml_thumbnail/test/default.jpg\",\"tags\":[\"abc\",\"def\"],\"AITags\":null,\"isPrivateFile\":true,\"customCoordinates\":null,\"metadata\":{\"height\":700,\"width\":1050,\"size\":102117,\"format\":\"jpg\",\"hasColorProfile\":true,\"quality\":0,\"density\":72,\"hasTransparency\":false,\"exif\":{},\"pHash\":\"90249d9b1fc74367\"}}"
+```
 
 ## Utility functions
 

data/lib/active_storage/service/image_kit_io_service.rb

@@ -3,7 +3,7 @@ require_relative './ik_file'
 if defined? Rails
   # Overwrite the ActiveStorage::Downloader's open method and remove the file integrity check constraint method verify_integrity_of
   class DownloaderExtension < ::ActiveStorage::Downloader
-    def open(key, checksum:, name: "ActiveStorage-", tmpdir: nil)
+    def open(key, checksum:, name: "ActiveStorage-", tmpdir: nil, **options)
       open_tempfile(name, tmpdir) do |file|
         download key, file
         # verify_integrity_of file, checksum: checksum
@@ -71,9 +71,11 @@ if defined? Rails
       def upload(key, io, checksum: nil, **options)
         instrument :upload, key: key, checksum: checksum do
           blob = storage_blob(key)
-          response = client.upload_file(file: io, file_name: blob.filename.to_s)
+          response = client.upload_file(file: io, file_name: blob.filename.to_s, content_type: blob.content_type)
           if response[:error].nil?
             blob.update_columns(metadata: response[:response].transform_keys(&:to_sym))
+          else
+            raise Exception.new response[:error]
           end
         end
       end

data/lib/imagekitio/api_service/file.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 require_relative '../constant'
 require_relative '../utils/option_validator'
+require 'net/http/post/multipart'
 
 module ImageKitIo
   module ApiService
@@ -32,6 +33,7 @@ module ImageKitIo
         raise ArgumentError, constants.MISSING_UPLOAD_FILE_PARAMETER unless file
         raise ArgumentError, constants.MISSING_UPLOAD_FILE_PARAMETER unless file_name
 
+        content_type = options.delete(:content_type) || ''
         options = format_to_json(options, :extensions, Array)
         options = format_to_json(options, :custom_metadata, Hash)
         options = validate_upload_options(options || {})
@@ -39,7 +41,12 @@ module ImageKitIo
           raise ArgumentError, "Invalid Upload option"
         else
           headers = @req_obj.create_headers
-          payload = {multipart: true, file: file, fileName: file_name}.merge(options)
+          payload =  {
+            multipart: true,
+            file: file.is_a?(String) ? file : ::UploadIO.new(file, content_type, file_name),
+            fileName: file_name
+          }
+          payload.merge!(options)
           url = "#{constants.BASE_URL}#{constants.UPLOAD}"
           @req_obj.request("post", url, headers, payload)
         end
@@ -68,6 +75,51 @@ module ImageKitIo
         @req_obj.request("get", url, headers, formatted_options)
       end
 
+      def get_file_versions(file_id: nil)
+        if file_id == '' || file_id.nil?
+          raise ArgumentError, 'file_id is required'
+        end
+        url = "#{constants.BASE_URL}/#{file_id}/versions"
+        headers = @req_obj.create_headers
+        @req_obj.request('get', url, headers)
+      end
+
+      def get_file_version_detail(file_id: nil, version_id: nil)
+        if file_id == "" || file_id.nil?
+          raise ArgumentError, "file_id is required"
+        end
+        if version_id == "" || version_id.nil?
+          raise ArgumentError, "version_id is required"
+        end
+        url = "#{constants.BASE_URL}/#{file_id}/versions/#{version_id}"
+        headers = @req_obj.create_headers
+        @req_obj.request('get', url, headers)
+      end
+
+      def delete_file_version(file_id: nil, version_id: nil)
+        if file_id == "" || file_id.nil?
+          raise ArgumentError, "file_id is required"
+        end
+        if version_id == "" || version_id.nil?
+          raise ArgumentError, "version_id is required"
+        end
+        url = "#{constants.BASE_URL}/#{file_id}/versions/#{version_id}"
+        headers = @req_obj.create_headers
+        @req_obj.request('delete', url, headers)
+      end
+
+      def restore_file_version(file_id: nil, version_id: nil)
+        if file_id == "" || file_id.nil?
+          raise ArgumentError, "file_id is required"
+        end
+        if version_id == "" || version_id.nil?
+          raise ArgumentError, "version_id is required"
+        end
+        url = "#{constants.BASE_URL}/#{file_id}/versions/#{version_id}/restore"
+        headers = @req_obj.create_headers
+        @req_obj.request('put', url, headers)
+      end
+
       def details(file_identifier: nil)
         # Get detail of file by file_identifier
         if file_identifier == "" || file_identifier.nil?
@@ -131,12 +183,12 @@ module ImageKitIo
         @req_obj.request_stream('get', remote_file_url, headers: @req_obj.create_headers, &block)
       end
 
-      def copy(source_file_path: nil, destination_path: nil)
+      def copy(source_file_path: nil, destination_path: nil, include_file_versions: false)
         if source_file_path == '' || source_file_path.nil? || destination_path == '' || destination_path.nil?
           raise ArgumentError, 'parameters required'
         end
         url = "#{constants.BASE_URL}/copy"
-        payload = { 'sourceFilePath': source_file_path, 'destinationPath': destination_path }
+        payload = { 'sourceFilePath': source_file_path, 'destinationPath': destination_path, 'includeFileVersions': include_file_versions }.to_json
         @req_obj.request('post', url, @req_obj.create_headers, payload)
       end
 
@@ -157,6 +209,12 @@ module ImageKitIo
         payload = { 'filePath': file_path, 'newFileName': new_file_name }.merge(request_formatter(options)).to_json
         @req_obj.request('put', url, @req_obj.create_headers, payload)
       end
+
+
+      private
+      def image_format?(type)
+        %(image/jpeg image/bmp image/apng image/avif image/gif image/ief image/svg+xml image/tiff image/x-icon image/rgb image/webp).include?(type)
+      end
     end
   end
 end

data/lib/imagekitio/api_service/folder.rb

@@ -27,12 +27,12 @@ module ImageKitIo
         @req_obj.request('delete', url, @req_obj.create_headers, payload)
       end
 
-      def copy(source_folder_path: nil, destination_path: nil)
+      def copy(source_folder_path: nil, destination_path: nil, include_file_versions: false)
         if source_folder_path == '' || source_folder_path.nil? || destination_path == '' || destination_path.nil?
           raise ArgumentError, 'Parameters required'
         end
         url = "#{constants.BULK_BASE_URL}/copyFolder"
-        payload = { 'sourceFolderPath': source_folder_path, 'destinationPath': destination_path }
+        payload = { 'sourceFolderPath': source_folder_path, 'destinationPath': destination_path, 'includeFileVersions': include_file_versions }.to_json
         @req_obj.request('post', url, @req_obj.create_headers, payload)
       end
 

data/lib/imagekitio/client.rb

@@ -65,6 +65,22 @@ module ImageKitIo
       @file_service.list(**options)
     end
 
+    def file_versions(file_id: nil)
+      @file_service.get_file_versions(file_id: file_id)
+    end
+
+    def file_version_detail(file_id: nil, version_id: nil)
+      @file_service.get_file_version_detail(file_id: file_id, version_id: version_id)
+    end
+
+    def delete_file_version(file_id: nil, version_id: nil)
+      @file_service.delete_file_version(file_id: file_id, version_id: version_id)
+    end
+
+    def restore_file_version(file_id: nil, version_id: nil)
+      @file_service.restore_file_version(file_id: file_id, version_id: version_id)
+    end
+
     def get_file_details(file_id: nil)
       # Get file detail by file-id or file_url
       @file_service.details(file_identifier: file_id)
@@ -104,8 +120,8 @@ module ImageKitIo
       @file_service.stream_file(remote_file_url: file_url, &block)
     end
 
-    def copy_file(source_file_path: nil, destination_path: nil)
-      @file_service.copy(source_file_path: source_file_path, destination_path: destination_path)
+    def copy_file(source_file_path: nil, destination_path: nil, include_file_versions: false)
+      @file_service.copy(source_file_path: source_file_path, destination_path: destination_path, include_file_versions: include_file_versions)
     end
 
     def move_file(source_file_path: nil, destination_path: nil)
@@ -145,8 +161,8 @@ module ImageKitIo
       @folder_service.delete(folder_path: folder_path)
     end
 
-    def copy_folder(source_folder_path: nil, destination_path: nil)
-      @folder_service.copy(source_folder_path: source_folder_path, destination_path: destination_path)
+    def copy_folder(source_folder_path: nil, destination_path: nil, include_file_versions: false)
+      @folder_service.copy(source_folder_path: source_folder_path, destination_path: destination_path, include_file_versions: include_file_versions)
     end
 
     def move_folder(source_folder_path: nil, destination_path: nil)

data/lib/imagekitio/constants/file.rb

@@ -5,7 +5,7 @@ module ImageKitIo
 
       VALID_FILE_DETAIL_OPTIONS = ["fileID"]
 
-      VALID_UPLOAD_OPTIONS = %w[file file_name use_unique_file_name tags folder is_private_file custom_coordinates response_fields extensions webhook_url overwrite_file overwrite_AI_tags overwrite_custom_metadata custom_metadata mime overwrite_tags  ]
+      VALID_UPLOAD_OPTIONS = %w[file file_name use_unique_file_name tags folder is_private_file custom_coordinates response_fields extensions webhook_url overwrite_file overwrite_AI_tags overwrite_custom_metadata custom_metadata mime overwrite_tags content_type  ]
     end
   end
 end

data/lib/imagekitio/request.rb

@@ -3,6 +3,7 @@
 require "base64"
 require "rest-client"
 require "json"
+require 'net/http/post/multipart'
 require_relative './constant'
 # Request requests and sends data from server
 module ImageKitIo
@@ -33,28 +34,46 @@ module ImageKitIo
     # request method communicates with server
     def request(method, url, headers = create_headers, payload = nil)
       headers ||= create_headers
-      response = {response: nil, error: nil}
+      response = {}
       begin
-        resp = RestClient::Request.new(method: method,
-                                       url: url,
-                                       headers: headers,
-                                       payload: payload).execute
-
-        if (resp.code >= 200) && (resp.code < 204)
-          if (resp.headers[:content_type].include? "application/json")
+        if(method.downcase.to_sym == :post && payload.is_a?(Hash) && payload[:multipart])
+          uri = URI.parse(url)
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.use_ssl = (uri.scheme == 'https')
+          req = Net::HTTP::Post::Multipart.new uri.path, payload, headers
+          resp = http.request(req)
+          response[:headers] = resp.to_hash
+        else
+          resp = RestClient::Request.new(method: method,
+                                         url: url,
+                                         headers: headers,
+                                         payload: payload).execute
+          response[:headers] = resp.raw_headers
+        end
+        response[:raw_body] = resp.body
+        response[:status_code] = resp.code
+        resp_c = resp.code.to_i
+        if [400, 403].include?(resp_c)
+          raise RestClient::ExceptionWithResponse, OpenStruct.new({ body: resp.body, code: resp_c, headers: response[:headers] })
+        end
+        if (resp.code.to_i >= 200) && (resp.code.to_i < 204)
+          content_type = resp.respond_to?(:headers) ? resp.headers[:content_type] : resp.content_type
+          if (content_type.include? "application/json")
             response[:response] = JSON.parse(resp.body.to_s)
           else
-            raise =RestClient::ExceptionWithResponse
+            raise RestClient::ExceptionWithResponse, OpenStruct.new(code: 404, body: resp.body)
           end
-        elsif resp.code == 204
+        elsif resp.code.to_i == 204
           response[:response] = {'success': true}
         end
 
       rescue RestClient::ExceptionWithResponse => err
-        response[:error] = if err.http_code == 404
+        response[:status_code] = err.http_code if response[:status_code].nil?
+        response[:headers] = err.http_headers if response[:headers].nil?
+        response[:error] = if err.http_code.to_i == 404
                              {'message': err.response.to_s}
                            else
-                             JSON.parse(err.response)
+                             err.response.is_a?(OpenStruct) ? JSON.parse(err.response.body) : JSON.parse(err.response)
                            end
       end
       response

data/lib/imagekitio/sdk/version.rb

@@ -1,5 +1,5 @@
 module ImageKitIo
   module Sdk
-    VERSION = '2.0.1'
+    VERSION = '2.2.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imagekitio
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.2.0
 platform: ruby
 authors:
 - ImageKit.io team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-10 00:00:00.000000000 Z
+date: 2022-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: carrierwave
@@ -78,6 +78,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.0
+- !ruby/object:Gem::Dependency
+  name: multipart-post
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -157,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.32
+rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
 summary: Automate image optimization on rails platforms.