files.com 1.1.597 → 1.1.598

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 688e7875040976b74cdc2bf245f054fe4e005125685d27af769ad4a7cb9660c1
-  data.tar.gz: 907bfe4f027b890868115ec5adef64664050bbd18b68397fc41d9a730e11ff78
+  metadata.gz: 4eb1e3edc5f2b456c8e477c29015566cb158904c76133f95c3b0f47280259c0f
+  data.tar.gz: 5dad72b649848fd879dce367f8d61e95ada837164d1f10791bfc12ceb07699ef
 SHA512:
-  metadata.gz: 4393537027f1dc7f5fb31e6789a1202b8b80480af9896179ecf9e3433e6385c5e9fd0bcb774e6a293c05b7e07cb670105426df20c253a504bdea68a5d7a644e6
-  data.tar.gz: bf9ccccbb7e6d3d01e3289a2c5afe1ddc355d62c3f8749e535025002b8cc3ae83757268c42f63e992c9175c4ff954c9ea1a1c9bdad071c6a08a72f2af6e52141
+  metadata.gz: 63d82719bd0f2a75d488ab6b56697a704bc9ab808b6720bdb067cafaedac3b3e18f3c0b114d8469f7fc4bc4fbf5ef3a35c959a1d2b106a987f78195779014ea5
+  data.tar.gz: efb2566edb01bc24fde3aae8522670c0ccf271bcf9db4f1869aa7cecdadad4b57364fe683980da8556fc4b1c6c7937517534bbed55555c3b2cd06bb040d1f33e

data/_VERSION

@@ -1 +1 @@
-1.1.597
+1.1.598

data/docs/sync.md

@@ -68,7 +68,18 @@
     "successful_files": 1,
     "sync_id": 1,
     "sync_name": "Azure to SharePoint Sync",
-    "updated_at": "2000-01-01T01:00:00Z"
+    "updated_at": "2000-01-01T01:00:00Z",
+    "live_transfers": [
+      {
+        "path": "example",
+        "status": "example",
+        "bytes_copied": 1,
+        "bytes_total": 1,
+        "percentage": 1.0,
+        "eta": "example",
+        "started_at": "example"
+      }
+    ]
   }
 }
 ```

data/docs/sync_run.md

@@ -27,7 +27,18 @@
   "successful_files": 1,
   "sync_id": 1,
   "sync_name": "Azure to SharePoint Sync",
-  "updated_at": "2000-01-01T01:00:00Z"
+  "updated_at": "2000-01-01T01:00:00Z",
+  "live_transfers": [
+    {
+      "path": "example",
+      "status": "example",
+      "bytes_copied": 1,
+      "bytes_total": 1,
+      "percentage": 1.0,
+      "eta": "example",
+      "started_at": "example"
+    }
+  ]
 }
 ```
 
@@ -53,6 +64,7 @@
 * `sync_id` (int64): ID of the Sync this run belongs to
 * `sync_name` (string): Name of the Sync this run belongs to
 * `updated_at` (date-time): When this run was last updated
+* `live_transfers` (array(object)): Array of in-progress file transfers with progress data. Only present when the sync run status is in_progress.
 
 
 ---

data/docs/sync_run_live_transfer.md

@@ -0,0 +1,23 @@
+# SyncRunLiveTransfer
+
+## Example SyncRunLiveTransfer Object
+
+```
+{
+  "path": "example",
+  "status": "example",
+  "bytes_copied": 1,
+  "bytes_total": 1,
+  "percentage": 1.0,
+  "eta": "example",
+  "started_at": "example"
+}
+```
+
+* `path` (string): The file path being transferred. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `status` (string): Status of this individual transfer
+* `bytes_copied` (int64): Bytes transferred so far
+* `bytes_total` (int64): Total bytes of the file being transferred
+* `percentage` (double): Transfer progress from 0.0 to 1.0
+* `eta` (string): Estimated time remaining (human-readable)
+* `started_at` (string): When this individual transfer started

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

@@ -119,6 +119,11 @@ module Files
       @attributes[:updated_at]
     end
 
+    # array(object) - Array of in-progress file transfers with progress data. Only present when the sync run status is in_progress.
+    def live_transfers
+      @attributes[:live_transfers]
+    end
+
     # Parameters:
     #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   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.

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Files
+  class SyncRunLiveTransfer
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - The file path being transferred. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    def path
+      @attributes[:path]
+    end
+
+    # string - Status of this individual transfer
+    def status
+      @attributes[:status]
+    end
+
+    # int64 - Bytes transferred so far
+    def bytes_copied
+      @attributes[:bytes_copied]
+    end
+
+    # int64 - Total bytes of the file being transferred
+    def bytes_total
+      @attributes[:bytes_total]
+    end
+
+    # double - Transfer progress from 0.0 to 1.0
+    def percentage
+      @attributes[:percentage]
+    end
+
+    # string - Estimated time remaining (human-readable)
+    def eta
+      @attributes[:eta]
+    end
+
+    # string - When this individual transfer started
+    def started_at
+      @attributes[:started_at]
+    end
+  end
+end

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -138,6 +138,7 @@ require "files.com/models/style"
 require "files.com/models/sync"
 require "files.com/models/sync_log"
 require "files.com/models/sync_run"
+require "files.com/models/sync_run_live_transfer"
 require "files.com/models/usage_by_top_level_dir"
 require "files.com/models/usage_daily_snapshot"
 require "files.com/models/usage_snapshot"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.597
+  version: 1.1.598
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-04-06 00:00:00.000000000 Z
+date: 2026-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -277,6 +277,7 @@ files:
 - docs/sync.md
 - docs/sync_log.md
 - docs/sync_run.md
+- docs/sync_run_live_transfer.md
 - docs/usage_by_top_level_dir.md
 - docs/usage_daily_snapshot.md
 - docs/usage_snapshot.md
@@ -403,6 +404,7 @@ files:
 - lib/files.com/models/sync.rb
 - lib/files.com/models/sync_log.rb
 - lib/files.com/models/sync_run.rb
+- lib/files.com/models/sync_run_live_transfer.rb
 - lib/files.com/models/usage_by_top_level_dir.rb
 - lib/files.com/models/usage_daily_snapshot.rb
 - lib/files.com/models/usage_snapshot.rb