files.com 1.1.766 → 1.1.767

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0bb1d5b48b96119ec91525d8f055be9455d19406b796869d5e9db694bc10e34d
-  data.tar.gz: 3b963488ee21b159a12a9bd256e343d0e86987f4ac8701de9e3eccc1fdc86876
+  metadata.gz: 0f28911c7269ba7bca7b67e635c974300c1766dffd95239e2755bc3e6fd59309
+  data.tar.gz: 10abf8ff3c46f32c466f3658c2c86b9953771c13664af3665fee10a4108d3cf4
 SHA512:
-  metadata.gz: ebe6a92f79a33732e665c36dec9269f648bb77be622659921ae9594fb703eebc457e628b058daa103ba693a15df62410b8c0e87f9b4f1f0eda714cda06937a15
-  data.tar.gz: 279cacd8d1dbadfb490ecbbecfd8a1069b019633469e731c1fac550aa42791f601c2f173868681b8d78fc71ed5d9f1dded664bc45c3cd27ac524e9e9e647e4e7
+  metadata.gz: a44129f9828a4d647097cb1d86af56940f5402e71c389e6fdc74ba693e3a60f06b4f724201b5a625c5ee13c3768db7daf9f8b2ab31379c66b3a3c35240fbcd1a
+  data.tar.gz: 6337ed3e62e953bd9d51d0da29f2d87079b4b8d0b1408061cc6a571405255f3b3c7247247da48bea29a6c7e473ee98b01889ca731467e4c47dd5c6a8c35d9e12

data/README.md

@@ -791,18 +791,45 @@ end
 
 ## Mock Server
 
-Files.com publishes a Files.com API server, which is useful for testing your use of the Files.com
+Files.com publishes a mock Files.com API server, which is useful for testing your use of the Files.com
 SDKs and other direct integrations against the Files.com API in an integration test environment.
-
-It is a Ruby app that operates as a minimal server for the purpose of testing basic network
-operations and JSON encoding for your SDK or API client. It does not maintain state and it does not
-deeply inspect your submissions for correctness.
-
-Eventually we will add more features intended for integration testing, such as the ability to
-intentionally provoke errors.
+It never checks credentials: send any placeholder API key, and never use real Files.com credentials
+with it.
+
+The server has two modes, chosen when it starts:
+
+* **Legacy mode** (the default) checks required parameters and parameter types, then returns a fixed
+  example response for each API endpoint. It does not maintain state and it does not deeply inspect
+  your submissions for correctness, which makes it useful for testing basic network operations and
+  JSON encoding for your SDK or API client.
+* **Simulation mode** keeps records, files and folders in memory, so a test can create, list, update
+  and delete resources, upload a file and download the same bytes, and make chosen requests fail,
+  stall or lose their connection on purpose. Requests it does not simulate fail with a clear error
+  instead of returning an example response.
+
+Start the server from its source with Ruby and Bundler. `FILES_MOCK_MODE` is read once at startup:
+leaving it unset or setting it to `legacy` starts legacy mode, `simulation` starts simulation mode,
+and any other value stops startup with an error. Legacy mode listens on port 4041 on all IPv4
+interfaces, and simulation mode on `127.0.0.1:4041`.
+
+Simulation mode keeps its state only in the server process. Its control endpoints under
+`/__files_mock/v1` report when the server is ready, reset it with your fixtures, add fault rules
+and return the journal of the requests it received. It refuses work over its limits instead of
+truncating it. The README in the source describes all of these, the operations it simulates and
+how to configure its limits.
 
 Download the server as a Docker image via [Docker Hub](https://hub.docker.com/r/filescom/files-mock-server).
+The image's `latest` tag moves to whichever server was published last, so it need not include
+simulation mode; to run exactly the server the README describes, build the image from the source.
 
 The Source Code is also available on [GitHub](https://github.com/Files-com/files-mock-server).
 
-A README is available on the GitHub link.
+```shell title="Start the Mock Server"
+bundle install
+
+## Legacy mode
+bundle exec puma
+
+## Simulation mode
+FILES_MOCK_MODE=simulation bundle exec puma
+```

data/_VERSION

@@ -1 +1 @@
-1.1.766
+1.1.767

data/docs/ai_task.md

@@ -80,7 +80,7 @@ Files::AiTask.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: 10000, 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 `workspace_id`, `id`, `disabled` or `updated_at`.
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `name`, `disabled` or `updated_at`.
 * `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `disabled`, `trigger` or `workspace_id`. Valid field combinations are `[ workspace_id, disabled ]`.
 
 

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

@@ -303,7 +303,7 @@ module Files
     # Parameters:
     #   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: 10000, 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 `workspace_id`, `id`, `disabled` or `updated_at`.
+    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `name`, `disabled` or `updated_at`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `disabled`, `trigger` or `workspace_id`. Valid field combinations are `[ workspace_id, disabled ]`.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)

data/lib/files.com/version.rb

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

metadata

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