files.com 1.1.659 → 1.1.661

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b36753869a0e4f64a0feb2ff8e58d04ce3310b76925b0f035373d5d355d35052
-  data.tar.gz: aa9037ee2eedf8c928b2389859faea3615c91ce341e4715a5ffee06ec0c921a1
+  metadata.gz: f5d1657cd2960ca08a61d277113bab0c606889dbcd13de1a0f0101f60bce5cf5
+  data.tar.gz: 454cec2c47344387c5ecf6bcb290ec2e23563f4213d98a27143619e0ed5de982
 SHA512:
-  metadata.gz: 61e797a9c2f9beab60fe3f55223f2ab673d78af23710245ea369702b2924235ae997917714cca4f3eb8bf8f1b7951e27d7aae388510c0878dc506be95f8d0073
-  data.tar.gz: 4775a3a6d5d9ebd9dcba86c2a9f89b64b8583c7135d7c42483da7d9cd90b052e602ada496ff0963487e935598ad20ad828ae7b14a758458a7a50829f7d75cb05
+  metadata.gz: eb6e585c04932db0c0d34aceef06ad83f1f4ef7cd97adf00255e0ff26a9720098ef64b0903d35e9c963f21348bd926eae24f457b86d678b6469894cae21bc94f
+  data.tar.gz: 85eb230534050c522e8f42b21bffa8e505edc489b1a12e4ea6f2f7fdc40c5451371275085c0494b7e23489ac8f2b8da5c145c640f2632b12b1e648c7cc440e5f

data/_VERSION

@@ -1 +1 @@
-1.1.659
+1.1.661

data/docs/bundle.md

@@ -61,6 +61,7 @@
   "deleted_at": "2000-01-01T01:00:00Z",
   "dont_separate_submissions_by_folder": true,
   "max_uses": 1,
+  "internal_name": "Quarterly reports",
   "note": "The internal note on the bundle.",
   "path_template": "{{name}}_{{ip}}",
   "path_template_time_zone": "Eastern Time (US & Canada)",
@@ -122,6 +123,7 @@
 * `deleted_at` (date-time): Bundle deleted at date/time
 * `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
+* `internal_name` (string): Internal name for identifying this Share Link.
 * `note` (string): Bundle internal note
 * `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, `strftime` directives, and any custom form data.
 * `path_template_time_zone` (string): Timezone to use when rendering timestamps in path templates.
@@ -207,6 +209,7 @@ Files::Bundle.create(
   finalize_snapshot: false, 
   max_uses: 1, 
   group_id: 1, 
+  internal_name: "Quarterly reports", 
   description: "The public description of the bundle.", 
   note: "The internal note on the bundle.", 
   code: "abc123", 
@@ -241,6 +244,7 @@ Files::Bundle.create(
 * `finalize_snapshot` (boolean): If true, finalize the snapshot of this bundle's contents. Note that `create_snapshot` must also be true.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `group_id` (int64): Owning group ID. If set, members of this group can view, edit, and share this Share Link.
+* `internal_name` (string): Internal name for identifying this Share Link.
 * `description` (string): Public description
 * `note` (string): Bundle internal note
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
@@ -302,6 +306,7 @@ Files::Bundle.update(id,
   inbox_id: 1, 
   max_uses: 1, 
   group_id: 1, 
+  internal_name: "Quarterly reports", 
   note: "The internal note on the bundle.", 
   path_template: "{{name}}_{{ip}}", 
   path_template_time_zone: "Eastern Time (US & Canada)", 
@@ -337,6 +342,7 @@ Files::Bundle.update(id,
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `group_id` (int64): Owning group ID. If set, members of this group can view, edit, and share this Share Link.
+* `internal_name` (string): Internal name for identifying this Share Link.
 * `note` (string): Bundle internal note
 * `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, `strftime` directives, and any custom form data.
 * `path_template_time_zone` (string): Timezone to use when rendering timestamps in path templates.
@@ -412,6 +418,7 @@ bundle.update(
   inbox_id: 1,
   max_uses: 1,
   group_id: 1,
+  internal_name: "Quarterly reports",
   note: "The internal note on the bundle.",
   path_template: "{{name}}_{{ip}}",
   path_template_time_zone: "Eastern Time (US & Canada)",
@@ -447,6 +454,7 @@ bundle.update(
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `group_id` (int64): Owning group ID. If set, members of this group can view, edit, and share this Share Link.
+* `internal_name` (string): Internal name for identifying this Share Link.
 * `note` (string): Bundle internal note
 * `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, `strftime` directives, and any custom form data.
 * `path_template_time_zone` (string): Timezone to use when rendering timestamps in path templates.

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/bundle.rb

@@ -257,6 +257,15 @@ module Files
       @attributes[:max_uses] = value
     end
 
+    # string - Internal name for identifying this Share Link.
+    def internal_name
+      @attributes[:internal_name]
+    end
+
+    def internal_name=(value)
+      @attributes[:internal_name] = value
+    end
+
     # string - Bundle internal note
     def note
       @attributes[:note]
@@ -507,6 +516,7 @@ module Files
     #   inbox_id - int64 - ID of the associated inbox, if available.
     #   max_uses - int64 - Maximum number of times bundle can be accessed
     #   group_id - int64 - Owning group ID. If set, members of this group can view, edit, and share this Share Link.
+    #   internal_name - string - Internal name for identifying this Share Link.
     #   note - string - Bundle internal note
     #   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, `strftime` directives, and any custom form data.
     #   path_template_time_zone - string - Timezone to use when rendering timestamps in path templates.
@@ -538,6 +548,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: internal_name must be an String") if params[:internal_name] and !params[:internal_name].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: path_template_time_zone must be an String") if params[:path_template_time_zone] and !params[:path_template_time_zone].is_a?(String)
@@ -638,6 +649,7 @@ module Files
     #   finalize_snapshot - boolean - If true, finalize the snapshot of this bundle's contents. Note that `create_snapshot` must also be true.
     #   max_uses - int64 - Maximum number of times bundle can be accessed
     #   group_id - int64 - Owning group ID. If set, members of this group can view, edit, and share this Share Link.
+    #   internal_name - string - Internal name for identifying this Share Link.
     #   description - string - Public description
     #   note - string - Bundle internal note
     #   code - string - Bundle code.  This code forms the end part of the Public URL.
@@ -665,6 +677,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: expires_at must be an String") if params[:expires_at] and !params[:expires_at].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: internal_name must be an String") if params[:internal_name] and !params[:internal_name].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: description must be an String") if params[:description] and !params[:description].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: code must be an String") if params[:code] and !params[:code].is_a?(String)
@@ -716,6 +729,7 @@ module Files
     #   inbox_id - int64 - ID of the associated inbox, if available.
     #   max_uses - int64 - Maximum number of times bundle can be accessed
     #   group_id - int64 - Owning group ID. If set, members of this group can view, edit, and share this Share Link.
+    #   internal_name - string - Internal name for identifying this Share Link.
     #   note - string - Bundle internal note
     #   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, `strftime` directives, and any custom form data.
     #   path_template_time_zone - string - Timezone to use when rendering timestamps in path templates.
@@ -746,6 +760,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: internal_name must be an String") if params[:internal_name] and !params[:internal_name].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: path_template_time_zone must be an String") if params[:path_template_time_zone] and !params[:path_template_time_zone].is_a?(String)

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.661"
 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.661
 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