files.com 1.1.659 → 1.1.660

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b36753869a0e4f64a0feb2ff8e58d04ce3310b76925b0f035373d5d355d35052
-  data.tar.gz: aa9037ee2eedf8c928b2389859faea3615c91ce341e4715a5ffee06ec0c921a1
+  metadata.gz: 82209e3d411a0f6df1666efe608ea199a5293809e6cb7a20d4acbe7093e42695
+  data.tar.gz: 88273779926a5da5cb0f365bee0a3eaedcca4964883477897f6c60da311ecd64
 SHA512:
-  metadata.gz: 61e797a9c2f9beab60fe3f55223f2ab673d78af23710245ea369702b2924235ae997917714cca4f3eb8bf8f1b7951e27d7aae388510c0878dc506be95f8d0073
-  data.tar.gz: 4775a3a6d5d9ebd9dcba86c2a9f89b64b8583c7135d7c42483da7d9cd90b052e602ada496ff0963487e935598ad20ad828ae7b14a758458a7a50829f7d75cb05
+  metadata.gz: 80f6239481ce085d7b19ebfd1f62c2d2b81f055ca5481cf8edf30813a63407ff3cad3e0df3c7cfa6609f44aec30eeebeb8705077d3b047c421fd3d99a919144b
+  data.tar.gz: 9d105b1d03b25af9bb3d0d1ccabb08c1645baff7c83f34d53c87b28e728042a5fbd8b1860a7b851cd2e15e4376eb30401441d181d2b8cda11750f17e3ced7d18

data/_VERSION

@@ -1 +1 @@
-1.1.659
+1.1.660

data/docs/file.md

@@ -268,6 +268,32 @@ Files::File.move(path,
 * `overwrite` (boolean): Overwrite existing file(s) in the destination?
 
 
+---
+
+## Transform a file and save the output to a destination path
+
+```
+Files::File.transform(path, 
+  destination: "destination", 
+  transform_type: "transform_type", 
+  target_format: "target_format", 
+  width: 1, 
+  height: 1, 
+  overwrite: false
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `destination` (string): Required - Destination file path for the transformed output.
+* `transform_type` (string): Required - Transform type. Supported values are `image_convert` and `document_convert`.
+* `target_format` (string): Required - Destination format to create.
+* `width` (int64): Maximum output width for image_convert.
+* `height` (int64): Maximum output height for image_convert.
+* `overwrite` (boolean): Overwrite existing file in the destination?
+
+
 ---
 
 ## Decrypt a GPG-encrypted file and save it to a destination path
@@ -507,6 +533,34 @@ file.move(
 * `overwrite` (boolean): Overwrite existing file(s) in the destination?
 
 
+---
+
+## Transform a file and save the output to a destination path
+
+```
+file = Files::File.find(path)
+
+file.transform(
+  destination: "destination",
+  transform_type: "transform_type",
+  target_format: "target_format",
+  width: 1,
+  height: 1,
+  overwrite: false
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `destination` (string): Required - Destination file path for the transformed output.
+* `transform_type` (string): Required - Transform type. Supported values are `image_convert` and `document_convert`.
+* `target_format` (string): Required - Destination format to create.
+* `width` (int64): Maximum output width for image_convert.
+* `height` (int64): Maximum output height for image_convert.
+* `overwrite` (boolean): Overwrite existing file in the destination?
+
+
 ---
 
 ## Decrypt a GPG-encrypted file and save it to a destination path

data/lib/files.com/models/file.rb

@@ -1075,6 +1075,33 @@ module Files
       Api.send_request("/file_actions/move/#{@attributes[:path]}", :post, params, @options)
     end
 
+    # Transform a file and save the output to a destination path
+    #
+    # Parameters:
+    #   destination (required) - string - Destination file path for the transformed output.
+    #   transform_type (required) - string - Transform type. Supported values are `image_convert` and `document_convert`.
+    #   target_format (required) - string - Destination format to create.
+    #   width - int64 - Maximum output width for image_convert.
+    #   height - int64 - Maximum output height for image_convert.
+    #   overwrite - boolean - Overwrite existing file in the destination?
+    def transform(params = {})
+      params ||= {}
+      params[:path] = @attributes[:path]
+      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params[:destination] and !params[:destination].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: transform_type must be an String") if params[:transform_type] and !params[:transform_type].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: target_format must be an String") if params[:target_format] and !params[:target_format].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: width must be an Integer") if params[:width] and !params[:width].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: height must be an Integer") if params[:height] and !params[:height].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
+      raise MissingParameterError.new("Parameter missing: destination") unless params[:destination]
+      raise MissingParameterError.new("Parameter missing: transform_type") unless params[:transform_type]
+      raise MissingParameterError.new("Parameter missing: target_format") unless params[:target_format]
+
+      Api.send_request("/file_actions/transform/#{@attributes[:path]}", :post, params, @options)
+    end
+
     # Decrypt a GPG-encrypted file and save it to a destination path
     #
     # Parameters:
@@ -1331,6 +1358,33 @@ module Files
       FileAction.new(response.data, options)
     end
 
+    # Transform a file and save the output to a destination path
+    #
+    # Parameters:
+    #   destination (required) - string - Destination file path for the transformed output.
+    #   transform_type (required) - string - Transform type. Supported values are `image_convert` and `document_convert`.
+    #   target_format (required) - string - Destination format to create.
+    #   width - int64 - Maximum output width for image_convert.
+    #   height - int64 - Maximum output height for image_convert.
+    #   overwrite - boolean - Overwrite existing file in the destination?
+    def self.transform(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params[:destination] and !params[:destination].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: transform_type must be an String") if params[:transform_type] and !params[:transform_type].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: target_format must be an String") if params[:target_format] and !params[:target_format].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: width must be an Integer") if params[:width] and !params[:width].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: height must be an Integer") if params[:height] and !params[:height].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
+      raise MissingParameterError.new("Parameter missing: destination") unless params[:destination]
+      raise MissingParameterError.new("Parameter missing: transform_type") unless params[:transform_type]
+      raise MissingParameterError.new("Parameter missing: target_format") unless params[:target_format]
+
+      response, options = Api.send_request("/file_actions/transform/#{params[:path]}", :post, params, options)
+      FileAction.new(response.data, options)
+    end
+
     # Decrypt a GPG-encrypted file and save it to a destination path
     #
     # Parameters:

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.659"
+  VERSION = "1.1.660"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.659
+  version: 1.1.660
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-24 00:00:00.000000000 Z
+date: 2026-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable