files.com 1.1.520 → 1.1.522

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3b694a4c7a64e41d9532cacbb24fbcbe2745138a358274aab4a32c71afe3413
-  data.tar.gz: '07628c04989769b28e75854a37ebb3c37c11bc6b405070f5063fa305a3822060'
+  metadata.gz: 3412afc11b0b4f1c4810dc170840b823f56acfd14c7a4685642e59bcdf9c969e
+  data.tar.gz: 0b51a50195bac08ee53a6e093231a53f6aa0c7bea64ba62f2220f28d525dfaca
 SHA512:
-  metadata.gz: 2a692409362af91e242606c8d40b27c314c1da7a1b2ce2b3272794826352e32a331f89dd16b0f5b29c3d9f4be7ba3b5c123c2318c36b1c61684833925dcbd1d5
-  data.tar.gz: f6cf0e5bf66019ecc76e3589b0dae6be1ad85c863f3b3bce99ee528251fb22ebb189515c259b7953aefb07060ce79d97fa3716c4660d96c2cd7f672e277f04ff
+  metadata.gz: ce9b52ac781f15c3fa05e31620bd3440e3f9b5e1f14a754788b1eb4703c1f7cd6579cf6f197f26bedb78cb9cb06de07013aa4a33adc851d9630505b13a015825
+  data.tar.gz: 587d0d5729e45eab227f9ac3af77b7854c17635a4ad1941544bee363b394a41f932b5fd5aae0815c63daddb05fd8334c5bda00e83998347750e75d499abfb1b5

data/_VERSION

@@ -1 +1 @@
-1.1.520
+1.1.522

data/docs/automation_run.md

@@ -54,7 +54,7 @@ Files::AutomationRun.list(
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `automation_id`, `created_at` or `status`.
-* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `status`, `workspace_id` or `automation_id`. Valid field combinations are `[ automation_id, status ]`, `[ workspace_id, automation_id ]` or `[ workspace_id, automation_id, status ]`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `status`, `workspace_id` or `automation_id`. Valid field combinations are `[ workspace_id, status ]`, `[ automation_id, status ]`, `[ workspace_id, automation_id ]` or `[ workspace_id, automation_id, status ]`.
 * `automation_id` (int64): Required - ID of the associated Automation.
 
 

data/docs/bundle.md

@@ -154,7 +154,7 @@ Files::Bundle.list(
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `expires_at`.
-* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `expires_at`, `code` or `user_id`. Valid field combinations are `[ user_id, created_at ]` and `[ user_id, expires_at ]`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `expires_at`, `code` or `user_id`. Valid field combinations are `[ user_id, expires_at ]`.
 * `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at` and `expires_at`.
 * `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at` and `expires_at`.
 * `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `code`.

data/docs/file.md

@@ -212,6 +212,19 @@ Files::File.find(path,
 * `with_priority_color` (boolean): Include file priority color information?
 
 
+---
+
+## List the contents of a ZIP file
+
+```
+Files::File.zip_list_contents(path)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+
+
 ---
 
 ## Copy File/Folder
@@ -250,6 +263,44 @@ Files::File.move(path,
 * `overwrite` (boolean): Overwrite existing file(s) in the destination?
 
 
+---
+
+## Extract a ZIP file to a destination folder
+
+```
+Files::File.unzip(path, 
+  destination: "destination", 
+  overwrite: false
+)
+```
+
+### Parameters
+
+* `path` (string): Required - ZIP file path to extract.
+* `destination` (string): Required - Destination folder path for extracted files.
+* `filename` (string): Optional single entry filename to extract.
+* `overwrite` (boolean): Overwrite existing files in the destination?
+
+
+---
+
+## Create a ZIP from one or more paths and save it to a destination path
+
+```
+Files::File.zip(
+  paths: "paths", 
+  destination: "destination", 
+  overwrite: false
+)
+```
+
+### Parameters
+
+* `paths` (array(string)): Required - Paths to include in the ZIP.
+* `destination` (string): Required - Destination file path for the ZIP.
+* `overwrite` (boolean): Overwrite existing file in the destination?
+
+
 ---
 
 ## Begin File Upload
@@ -340,6 +391,21 @@ file.delete(
 * `recursive` (boolean): If true, will recursively delete folders.  Otherwise, will error on non-empty folders.
 
 
+---
+
+## List the contents of a ZIP file
+
+```
+file = Files::File.find(path)
+
+file.zip_list_contents
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+
+
 ---
 
 ## Copy File/Folder
@@ -382,6 +448,27 @@ file.move(
 * `overwrite` (boolean): Overwrite existing file(s) in the destination?
 
 
+---
+
+## Extract a ZIP file to a destination folder
+
+```
+file = Files::File.find(path)
+
+file.unzip(
+  destination: "destination",
+  overwrite: false
+)
+```
+
+### Parameters
+
+* `path` (string): Required - ZIP file path to extract.
+* `destination` (string): Required - Destination folder path for extracted files.
+* `filename` (string): Optional single entry filename to extract.
+* `overwrite` (boolean): Overwrite existing files in the destination?
+
+
 ---
 
 ## Begin File Upload

data/docs/zip_list_entry.md

@@ -0,0 +1,13 @@
+# ZipListEntry
+
+## Example ZipListEntry Object
+
+```
+{
+  "path": "example",
+  "size": 1
+}
+```
+
+* `path` (string): Entry path inside the ZIP. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `size` (int64): Uncompressed size in bytes.

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

@@ -84,7 +84,7 @@ module Files
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `automation_id`, `created_at` or `status`.
-    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `status`, `workspace_id` or `automation_id`. Valid field combinations are `[ automation_id, status ]`, `[ workspace_id, automation_id ]` or `[ workspace_id, automation_id, status ]`.
+    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `status`, `workspace_id` or `automation_id`. Valid field combinations are `[ workspace_id, status ]`, `[ automation_id, status ]`, `[ workspace_id, automation_id ]` or `[ workspace_id, automation_id, status ]`.
     #   automation_id (required) - int64 - ID of the associated Automation.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)

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

@@ -531,7 +531,7 @@ module Files
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `expires_at`.
-    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `expires_at`, `code` or `user_id`. Valid field combinations are `[ user_id, created_at ]` and `[ user_id, expires_at ]`.
+    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `expires_at`, `code` or `user_id`. Valid field combinations are `[ user_id, expires_at ]`.
     #   filter_gt - object - If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at` and `expires_at`.
     #   filter_gteq - object - If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at` and `expires_at`.
     #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `code`.

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

@@ -1019,6 +1019,17 @@ module Files
       nil
     end
 
+    # List the contents of a ZIP file
+    def zip_list_contents(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 MissingParameterError.new("Parameter missing: path") unless params[:path]
+
+      Api.send_request("/file_actions/zip_list/#{@attributes[:path]}", :get, params, @options)
+    end
+
     # Copy File/Folder
     #
     # Parameters:
@@ -1054,6 +1065,25 @@ module Files
       Api.send_request("/file_actions/move/#{@attributes[:path]}", :post, params, @options)
     end
 
+    # Extract a ZIP file to a destination folder
+    #
+    # Parameters:
+    #   destination (required) - string - Destination folder path for extracted files.
+    #   filename - string - Optional single entry filename to extract.
+    #   overwrite - boolean - Overwrite existing files in the destination?
+    def unzip(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: filename must be an String") if params[:filename] and !params[:filename].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
+      raise MissingParameterError.new("Parameter missing: destination") unless params[:destination]
+
+      Api.send_request("/file_actions/unzip", :post, params, @options)
+    end
+
     # Begin File Upload
     #
     # Parameters:
@@ -1193,6 +1223,19 @@ module Files
       find(path, params, options)
     end
 
+    # List the contents of a ZIP file
+    def self.zip_list_contents(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 MissingParameterError.new("Parameter missing: path") unless params[:path]
+
+      response, options = Api.send_request("/file_actions/zip_list/#{params[:path]}", :get, params, options)
+      response.data.map do |entity_data|
+        ZipListEntry.new(entity_data, options)
+      end
+    end
+
     # Copy File/Folder
     #
     # Parameters:
@@ -1228,6 +1271,39 @@ module Files
       FileAction.new(response.data, options)
     end
 
+    # Extract a ZIP file to a destination folder
+    #
+    # Parameters:
+    #   destination (required) - string - Destination folder path for extracted files.
+    #   filename - string - Optional single entry filename to extract.
+    #   overwrite - boolean - Overwrite existing files in the destination?
+    def self.unzip(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: filename must be an String") if params[:filename] and !params[:filename].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
+      raise MissingParameterError.new("Parameter missing: destination") unless params[:destination]
+
+      response, options = Api.send_request("/file_actions/unzip", :post, params, options)
+      FileAction.new(response.data, options)
+    end
+
+    # Parameters:
+    #   paths (required) - array(string) - Paths to include in the ZIP.
+    #   destination (required) - string - Destination file path for the ZIP.
+    #   overwrite - boolean - Overwrite existing file in the destination?
+    def self.zip(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: paths must be an Array") if params[:paths] and !params[:paths].is_a?(Array)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params[:destination] and !params[:destination].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: paths") unless params[:paths]
+      raise MissingParameterError.new("Parameter missing: destination") unless params[:destination]
+
+      response, options = Api.send_request("/file_actions/zip", :post, params, options)
+      FileAction.new(response.data, options)
+    end
+
     # Begin File Upload
     #
     # Parameters:

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Files
+  class ZipListEntry
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - Entry path inside the ZIP. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    def path
+      @attributes[:path]
+    end
+
+    # int64 - Uncompressed size in bytes.
+    def size
+      @attributes[:size]
+    end
+  end
+end

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -145,6 +145,7 @@ require "files.com/models/user_sftp_client_use"
 require "files.com/models/web_dav_action_log"
 require "files.com/models/webhook_test"
 require "files.com/models/workspace"
+require "files.com/models/zip_list_entry"
 
 require "files.com/models/dir"
 require "files.com/models/file_utils"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.520
+  version: 1.1.522
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-23 00:00:00.000000000 Z
+date: 2026-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -270,6 +270,7 @@ files:
 - docs/web_dav_action_log.md
 - docs/webhook_test.md
 - docs/workspace.md
+- docs/zip_list_entry.md
 - files.com.gemspec
 - lib/files.com.rb
 - lib/files.com/api.rb
@@ -391,6 +392,7 @@ files:
 - lib/files.com/models/web_dav_action_log.rb
 - lib/files.com/models/webhook_test.rb
 - lib/files.com/models/workspace.rb
+- lib/files.com/models/zip_list_entry.rb
 - lib/files.com/path_util.rb
 - lib/files.com/response.rb
 - lib/files.com/sizable_io.rb