files.com 1.1.686 → 1.1.687

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 246a1416bc8ed79a900f35e5f1f56fb2e57476c97a7a376afdea3aa47bf956fa
-  data.tar.gz: 4b9091d98d255c125ac2e2ccc1fced2a79f8c65c5b16565b4c7ce08215ad38fd
+  metadata.gz: 35ca8dcc5a237d7b76c6fa8e5b895bbc8e069b3429edf8b7e03b4fbecdd1e6ab
+  data.tar.gz: d381dcb01aa97e904c4be016758f914edbd50b7f9176b67229a4dfcd7ae8dfb0
 SHA512:
-  metadata.gz: 8323da63b4714464a3f8c9b5b918198b1fca38acf84dfc081d97b59cd32ebcf9482699dceeedd834e438cc74828c9786b648922186ad32c87db40f083aa8cab1
-  data.tar.gz: 7a34805b9239c869437097634e2388df0fb280397c0f75ceaadf84652b0ecb0b980616af60a6ca17d14062eef81ea55fb81e3f408c4c1d3c80c4a93e1a8a6cb5
+  metadata.gz: dc2da7f5c289cd1b596932cd5739d720cad84c76422fd9182e87a97897f9ab7798b18dbe1a4e4ef7b3ceaee944b568a73661820f40c92d14567fb2c2df492221
+  data.tar.gz: 44e06277c09e7361f821bad2ae86e9cf2d01a2f2143864047b0315a1c09789ba868af5cd7ed04a0ffb568d7d3054f219992a96306c83635d7d63f32a325c9d69

data/_VERSION

@@ -1 +1 @@
-1.1.686
+1.1.687

data/docs/direct_connection_info.md

@@ -0,0 +1,21 @@
+# DirectConnectionInfo
+
+## Example DirectConnectionInfo Object
+
+```
+{
+  "version": 1,
+  "server_name": "example",
+  "addresses": [
+    "example"
+  ],
+  "direct_uri": "example",
+  "ca_pem": "example"
+}
+```
+
+* `version` (int64): Direct connection information schema version.
+* `server_name` (string): TLS server name (SNI and Host header) for the Agent's direct transfer listener.
+* `addresses` (array(string)): Validated ip:port candidates that may be dialed over TCP+TLS for this transfer.
+* `direct_uri` (string): Signed HTTPS URI for direct Agent transfer traffic.
+* `ca_pem` (string): PEM-encoded CA certificate used to verify the Agent's direct transfer TLS certificate.

data/docs/file.md

@@ -41,6 +41,15 @@ may places where a Ruby File object can be used.
   "subfolders_locked?": true,
   "is_locked": true,
   "download_uri": "https://mysite.files.com/...",
+  "direct_connection_info": {
+    "version": 1,
+    "server_name": "example",
+    "addresses": [
+      "example"
+    ],
+    "direct_uri": "example",
+    "ca_pem": "example"
+  },
   "priority_color": "red",
   "preview_id": 1,
   "preview": {
@@ -85,6 +94,7 @@ may places where a Ruby File object can be used.
 * `subfolders_locked?` (boolean): Are subfolders locked and unable to be modified?
 * `is_locked` (boolean): Is this folder locked and unable to be modified?
 * `download_uri` (string): Link to download file. Provided only in response to a download request.
+* `direct_connection_info` (DirectConnectionInfo): Optional direct connection information for direct Agent transfer attempts
 * `priority_color` (string): Bookmark/priority color of file/folder
 * `preview_id` (int64): File preview ID
 * `preview` (Preview): File preview
@@ -99,6 +109,7 @@ may places where a Ruby File object can be used.
 * `structure` (string): If copying folder, copy just the structure?
 * `with_rename` (boolean): Allow file rename instead of overwrite?
 * `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+* `with_direct_connection_info` (boolean): Include optional direct connection information for a direct Agent transfer attempt?
 
 
 ---
@@ -108,7 +119,8 @@ may places where a Ruby File object can be used.
 ```
 Files::File.download(path, 
   with_previews: false, 
-  with_priority_color: false
+  with_priority_color: false, 
+  with_direct_connection_info: false
 )
 ```
 
@@ -119,6 +131,7 @@ Files::File.download(path,
 * `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 * `with_previews` (boolean): Include file preview information?
 * `with_priority_color` (boolean): Include file priority color information?
+* `with_direct_connection_info` (boolean): Include optional direct connection information for a direct Agent transfer attempt?
 
 
 ---
@@ -136,7 +149,8 @@ Files::File.create(path,
   size: 1, 
   copy_behaviors: false, 
   with_rename: false, 
-  buffered_upload: false
+  buffered_upload: false, 
+  with_direct_connection_info: false
 )
 ```
 
@@ -158,6 +172,7 @@ Files::File.create(path,
 * `structure` (string): If copying folder, copy just the structure?
 * `with_rename` (boolean): Allow file rename instead of overwrite?
 * `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+* `with_direct_connection_info` (boolean): Include optional direct connection information for a direct Agent transfer attempt?
 
 
 ---
@@ -396,7 +411,8 @@ Files::File.begin_upload(path,
   restart: 1, 
   size: 1, 
   with_rename: false, 
-  buffered_upload: false
+  buffered_upload: false, 
+  with_direct_connection_info: false
 )
 ```
 
@@ -411,6 +427,7 @@ Files::File.begin_upload(path,
 * `size` (int64): Total bytes of file being uploaded (include bytes being retained if appending/restarting).
 * `with_rename` (boolean): Allow file rename instead of overwrite?
 * `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+* `with_direct_connection_info` (boolean): Include optional direct connection information for a direct Agent transfer attempt?
 
 
 ---
@@ -422,7 +439,8 @@ file = Files::File.find(path)
 
 file.download(
   with_previews: false,
-  with_priority_color: false
+  with_priority_color: false,
+  with_direct_connection_info: false
 )
 ```
 
@@ -433,6 +451,7 @@ file.download(
 * `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 * `with_previews` (boolean): Include file preview information?
 * `with_priority_color` (boolean): Include file priority color information?
+* `with_direct_connection_info` (boolean): Include optional direct connection information for a direct Agent transfer attempt?
 
 
 ---
@@ -653,7 +672,8 @@ file.begin_upload(
   restart: 1,
   size: 1,
   with_rename: false,
-  buffered_upload: false
+  buffered_upload: false,
+  with_direct_connection_info: false
 )
 ```
 
@@ -668,3 +688,4 @@ file.begin_upload(
 * `size` (int64): Total bytes of file being uploaded (include bytes being retained if appending/restarting).
 * `with_rename` (boolean): Allow file rename instead of overwrite?
 * `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+* `with_direct_connection_info` (boolean): Include optional direct connection information for a direct Agent transfer attempt?

data/docs/file_upload_part.md

@@ -25,7 +25,16 @@
   "partsize": 1,
   "path": "",
   "ref": "upload-1",
-  "upload_uri": "example"
+  "upload_uri": "example",
+  "direct_connection_info": {
+    "version": 1,
+    "server_name": "example",
+    "addresses": [
+      "example"
+    ],
+    "direct_uri": "example",
+    "ca_pem": "example"
+  }
 }
 ```
 
@@ -45,3 +54,4 @@
 * `path` (string): New file path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `ref` (string): Reference name for this upload part
 * `upload_uri` (string): URI to upload this part to
+* `direct_connection_info` (DirectConnectionInfo): Optional direct connection information for direct Agent transfer attempts

data/docs/folder.md

@@ -43,6 +43,15 @@ Files::Dir is an alias of Files::Folder
   "subfolders_locked?": true,
   "is_locked": true,
   "download_uri": "https://mysite.files.com/...",
+  "direct_connection_info": {
+    "version": 1,
+    "server_name": "example",
+    "addresses": [
+      "example"
+    ],
+    "direct_uri": "example",
+    "ca_pem": "example"
+  },
   "priority_color": "red",
   "preview_id": 1,
   "preview": {
@@ -87,6 +96,7 @@ Files::Dir is an alias of Files::Folder
 * `subfolders_locked?` (boolean): Are subfolders locked and unable to be modified?
 * `is_locked` (boolean): Is this folder locked and unable to be modified?
 * `download_uri` (string): Link to download file. Provided only in response to a download request.
+* `direct_connection_info` (DirectConnectionInfo): Optional direct connection information for direct Agent transfer attempts
 * `priority_color` (string): Bookmark/priority color of file/folder
 * `preview_id` (int64): File preview ID
 * `preview` (Preview): File preview

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

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Files
+  class DirectConnectionInfo
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - Direct connection information schema version.
+    def version
+      @attributes[:version]
+    end
+
+    # string - TLS server name (SNI and Host header) for the Agent's direct transfer listener.
+    def server_name
+      @attributes[:server_name]
+    end
+
+    # array(string) - Validated ip:port candidates that may be dialed over TCP+TLS for this transfer.
+    def addresses
+      @attributes[:addresses]
+    end
+
+    # string - Signed HTTPS URI for direct Agent transfer traffic.
+    def direct_uri
+      @attributes[:direct_uri]
+    end
+
+    # string - PEM-encoded CA certificate used to verify the Agent's direct transfer TLS certificate.
+    def ca_pem
+      @attributes[:ca_pem]
+    end
+  end
+end

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

@@ -917,6 +917,15 @@ module Files
       @attributes[:download_uri] = value
     end
 
+    # DirectConnectionInfo - Optional direct connection information for direct Agent transfer attempts
+    def direct_connection_info
+      @attributes[:direct_connection_info]
+    end
+
+    def direct_connection_info=(value)
+      @attributes[:direct_connection_info] = value
+    end
+
     # string - Bookmark/priority color of file/folder
     def priority_color
       @attributes[:priority_color]
@@ -1043,6 +1052,15 @@ module Files
       @attributes[:buffered_upload] = value
     end
 
+    # boolean - Include optional direct connection information for a direct Agent transfer attempt?
+    def with_direct_connection_info
+      @attributes[:with_direct_connection_info]
+    end
+
+    def with_direct_connection_info=(value)
+      @attributes[:with_direct_connection_info] = value
+    end
+
     # Download File
     #
     # Parameters:
@@ -1050,6 +1068,7 @@ module Files
     #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
     #   with_previews - boolean - Include file preview information?
     #   with_priority_color - boolean - Include file priority color information?
+    #   with_direct_connection_info - boolean - Include optional direct connection information for a direct Agent transfer attempt?
     def download(params = {})
       params ||= {}
       params[:path] = @attributes[:path]
@@ -1248,6 +1267,7 @@ module Files
     #   size - int64 - Total bytes of file being uploaded (include bytes being retained if appending/restarting).
     #   with_rename - boolean - Allow file rename instead of overwrite?
     #   buffered_upload - boolean - If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+    #   with_direct_connection_info - boolean - Include optional direct connection information for a direct Agent transfer attempt?
     def begin_upload(params = {})
       params ||= {}
       params[:path] = @attributes[:path]
@@ -1276,6 +1296,7 @@ module Files
     #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
     #   with_previews - boolean - Include file preview information?
     #   with_priority_color - boolean - Include file priority color information?
+    #   with_direct_connection_info - boolean - Include optional direct connection information for a direct Agent transfer attempt?
     def self.download(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
@@ -1305,6 +1326,7 @@ module Files
     #   structure - string - If copying folder, copy just the structure?
     #   with_rename - boolean - Allow file rename instead of overwrite?
     #   buffered_upload - boolean - If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+    #   with_direct_connection_info - boolean - Include optional direct connection information for a direct Agent transfer attempt?
     def self.create(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
@@ -1547,6 +1569,7 @@ module Files
     #   size - int64 - Total bytes of file being uploaded (include bytes being retained if appending/restarting).
     #   with_rename - boolean - Allow file rename instead of overwrite?
     #   buffered_upload - boolean - If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
+    #   with_direct_connection_info - boolean - Include optional direct connection information for a direct Agent transfer attempt?
     def self.begin_upload(path, params = {}, options = {})
       params ||= {}
       params[:path] = path

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

@@ -88,5 +88,10 @@ module Files
     def upload_uri
       @attributes[:upload_uri]
     end
+
+    # DirectConnectionInfo - Optional direct connection information for direct Agent transfer attempts
+    def direct_connection_info
+      @attributes[:direct_connection_info]
+    end
   end
 end

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

@@ -434,6 +434,15 @@ module Files
       @attributes[:download_uri] = value
     end
 
+    # DirectConnectionInfo - Optional direct connection information for direct Agent transfer attempts
+    def direct_connection_info
+      @attributes[:direct_connection_info]
+    end
+
+    def direct_connection_info=(value)
+      @attributes[:direct_connection_info] = value
+    end
+
     # string - Bookmark/priority color of file/folder
     def priority_color
       @attributes[:priority_color]

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -68,6 +68,7 @@ require "files.com/models/child_site_management_policy"
 require "files.com/models/clickwrap"
 require "files.com/models/custom_domain"
 require "files.com/models/desktop_configuration_profile"
+require "files.com/models/direct_connection_info"
 require "files.com/models/dns_record"
 require "files.com/models/email_incoming_message"
 require "files.com/models/email_log"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.686
+  version: 1.1.687
 platform: ruby
 authors:
 - files.com
@@ -206,6 +206,7 @@ files:
 - docs/clickwrap.md
 - docs/custom_domain.md
 - docs/desktop_configuration_profile.md
+- docs/direct_connection_info.md
 - docs/dns_record.md
 - docs/email_incoming_message.md
 - docs/email_log.md
@@ -356,6 +357,7 @@ files:
 - lib/files.com/models/custom_domain.rb
 - lib/files.com/models/desktop_configuration_profile.rb
 - lib/files.com/models/dir.rb
+- lib/files.com/models/direct_connection_info.rb
 - lib/files.com/models/dns_record.rb
 - lib/files.com/models/email_incoming_message.rb
 - lib/files.com/models/email_log.rb