files.com 1.1.788 → 1.1.790

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e685f1474ddba361a9577273f6b22c995cca0168f798836efb1d6051c7521c8a
-  data.tar.gz: b3f5fde464659237dd56143436086a53cfb3133128e7c9a8a2c626234cd23922
+  metadata.gz: 7263d26603506f148888100768823d9809d751828ac46ba60fc000784aab81e5
+  data.tar.gz: 99dfd849c08d45a7a651e52e30d4818a37901cf7bc6a79adb7515bbd3ee922bd
 SHA512:
-  metadata.gz: f0a0f5c071bd1bd74046eba571ff7ea2b83926510f61013174bd7772251e03cca58208fcd3a82c884ba1785e8130d9f7f4330802241d6668374ec5cefcfcea63
-  data.tar.gz: a452e9ef9a1870b2ffb6d066f5ca76050bb6a1301fd8d77f959e73c57aae116739412b1b96534ce984b9265dc4afdf5d24510ba42b8c33abf68eb13e94a99e6a
+  metadata.gz: 91f17db1b746899e6ab064bdd164479d7a9aa91213d92a3b65b4f34e1f13eddacee743bc000320974dacf803411f88b5a2ddc03ab55f66c5125f8e1ee0e93c0e
+  data.tar.gz: 44115f507faa08f0d1cbecc00e779a0a2514e8449abf9e9f1f418db26d0cb48bc6c85e3e0dac8b7ca4076c9fbbf812052e51917e2c09e42a7158062cc0b7c221

data/README.md

@@ -833,8 +833,8 @@ end
 
 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 never checks credentials: send any placeholder API key, and never use real Files.com credentials
-with it.
+It never checks credentials: send any placeholder API key, such as `YOUR_API_KEY`, and never use
+real Files.com credentials with it.
 
 The server has two modes, chosen when it starts:
 
@@ -847,10 +847,38 @@ The server has two modes, chosen when it starts:
   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`.
+### Quick Start with Docker
+
+With [Docker](https://docs.docker.com/get-docker/) installed, start the published image from
+[Docker Hub](https://hub.docker.com/r/filescom/files-mock-server) with the command shown. It runs
+legacy mode at `http://127.0.0.1:4041`, reachable from your machine only: point your integration's
+Files.com API base URL there and use a placeholder API key. Stop it with Ctrl+C; `--rm` removes its
+container.
+
+The published image is built for `linux/amd64` only, so the command asks for that platform;
+without it, Docker on a machine of another architecture, such as an Apple silicon Mac, looks for
+an image the tag does not have. The `latest` tag moves to whichever server was published last,
+and `--pull=always` fetches it again each time, so it need not include simulation mode. To run
+simulation mode, build the image from the source as below.
+
+```shell title="Start the Mock Server with Docker"
+docker run --platform linux/amd64 --rm --pull=always -p 127.0.0.1:4041:4041 filescom/files-mock-server:latest
+
+## In another terminal, with a placeholder API key:
+curl -H "X-FilesAPI-Key: YOUR_API_KEY" http://127.0.0.1:4041/api/rest/v1/users
+```
+
+### Simulation Mode in Docker
+
+To run exactly the server the source's README describes, simulation mode included, build the image
+from a checkout of the source on [GitHub](https://github.com/Files-com/files-mock-server) and run
+it by the image ID you record with your test results. Only `linux/amd64` builds of the source have
+been checked, so both commands ask for that platform.
+
+Simulation mode listens only on loopback unless told otherwise, so the command binds it to the
+container's interfaces with `-b tcp://0.0.0.0:4041` and publishes the port on your machine's
+loopback address only. `FILES_MOCK_TRANSFER_ORIGIN` tells it the address your tests use, so the
+upload and download URLs it returns point at the published port.
 
 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
@@ -858,13 +886,27 @@ and return the journal of the requests it received. It refuses work over its lim
 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.
+```shell title="Simulation Mode from the Source"
+## In a checkout of the source:
+docker build --platform linux/amd64 -t files-mock-server:local .
+image=$(docker image inspect --format '{{.Id}}' files-mock-server:local)
+echo "$image"   # record this ID with your test results
+docker run --platform linux/amd64 --rm -e FILES_MOCK_MODE=simulation \
+  -e FILES_MOCK_TRANSFER_ORIGIN=http://127.0.0.1:40410 \
+  -p 127.0.0.1:40410:4041 "$image" -b tcp://0.0.0.0:4041
+
+## In another terminal:
+curl http://127.0.0.1:40410/__files_mock/v1/ready
+```
+
+### From the Source with Ruby
 
-The Source Code is also available on [GitHub](https://github.com/Files-com/files-mock-server).
+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`.
 
-```shell title="Start the Mock Server"
+```shell title="Start the Mock Server with Ruby"
 bundle install
 
 ## Legacy mode

data/_VERSION

@@ -1 +1 @@
-1.1.788
+1.1.790

data/docs/site.md

@@ -69,6 +69,7 @@
   "calculate_file_checksums_md5": true,
   "calculate_file_checksums_sha1": true,
   "calculate_file_checksums_sha256": true,
+  "child_site_folder_admins_can_see_parent_site_directory": true,
   "uploads_via_email_authentication": true,
   "color2_left": "#0066a7",
   "color2_link": "#d34f5d",
@@ -420,6 +421,7 @@
 * `calculate_file_checksums_md5` (boolean): Calculate MD5 checksums for files?
 * `calculate_file_checksums_sha1` (boolean): Calculate SHA1 checksums for files?
 * `calculate_file_checksums_sha256` (boolean): Calculate SHA256 checksums for files?
+* `child_site_folder_admins_can_see_parent_site_directory` (boolean): If true, administrators on this site's Child Sites, including Folder Admins, can list this site's Default Workspace users and groups and grant them folder permissions and notifications on Child Site paths.
 * `uploads_via_email_authentication` (boolean): Require email authentication, virus, and spam checks for incoming emails to Inboxes and Incoming Email Automations in every Workspace on this site?
 * `color2_left` (string): Page link and button color
 * `color2_link` (string): Top bar link color
@@ -728,6 +730,7 @@ Files::Site.update(
   group_admins_can_bypass_user_lifecycle_rules: false, 
   group_admins_can_reset_passwords: false, 
   group_admins_can_set_user_password: false, 
+  child_site_folder_admins_can_see_parent_site_directory: false, 
   bundle_recipient_blacklist_free_email_domains: false, 
   bundle_recipient_blacklist_domains: ["example"], 
   admins_bypass_locked_subfolders: false, 
@@ -917,6 +920,7 @@ Files::Site.update(
 * `group_admins_can_bypass_user_lifecycle_rules` (boolean): Allow group admins to exempt users in their groups from lifecycle rules
 * `group_admins_can_reset_passwords` (boolean): Allow group admins to reset passwords for users in their groups
 * `group_admins_can_set_user_password` (boolean): Allow group admins to set password authentication method
+* `child_site_folder_admins_can_see_parent_site_directory` (boolean): If true, administrators on this site's Child Sites, including Folder Admins, can list this site's Default Workspace users and groups and grant them folder permissions and notifications on Child Site paths.
 * `bundle_recipient_blacklist_free_email_domains` (boolean): Disallow free email domains for Bundle/Inbox recipients?
 * `bundle_recipient_blacklist_domains` (array(string)): List of email domains to disallow when entering a Bundle/Inbox recipients
 * `admins_bypass_locked_subfolders` (boolean): Allow admins to bypass the locked subfolders setting.

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

@@ -223,6 +223,11 @@ module Files
       @attributes[:calculate_file_checksums_sha256]
     end
 
+    # boolean - If true, administrators on this site's Child Sites, including Folder Admins, can list this site's Default Workspace users and groups and grant them folder permissions and notifications on Child Site paths.
+    def child_site_folder_admins_can_see_parent_site_directory
+      @attributes[:child_site_folder_admins_can_see_parent_site_directory]
+    end
+
     # boolean - Require email authentication, virus, and spam checks for incoming emails to Inboxes and Incoming Email Automations in every Workspace on this site?
     def uploads_via_email_authentication
       @attributes[:uploads_via_email_authentication]
@@ -1160,6 +1165,7 @@ module Files
     #   group_admins_can_bypass_user_lifecycle_rules - boolean - Allow group admins to exempt users in their groups from lifecycle rules
     #   group_admins_can_reset_passwords - boolean - Allow group admins to reset passwords for users in their groups
     #   group_admins_can_set_user_password - boolean - Allow group admins to set password authentication method
+    #   child_site_folder_admins_can_see_parent_site_directory - boolean - If true, administrators on this site's Child Sites, including Folder Admins, can list this site's Default Workspace users and groups and grant them folder permissions and notifications on Child Site paths.
     #   bundle_recipient_blacklist_free_email_domains - boolean - Disallow free email domains for Bundle/Inbox recipients?
     #   bundle_recipient_blacklist_domains - array(string) - List of email domains to disallow when entering a Bundle/Inbox recipients
     #   admins_bypass_locked_subfolders - boolean - Allow admins to bypass the locked subfolders setting.
@@ -1360,6 +1366,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: group_admins_can_bypass_user_lifecycle_rules must be a single value, not #{params[:group_admins_can_bypass_user_lifecycle_rules].class}") if [ Array, Hash ].any? { |klass| params[:group_admins_can_bypass_user_lifecycle_rules].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: group_admins_can_reset_passwords must be a single value, not #{params[:group_admins_can_reset_passwords].class}") if [ Array, Hash ].any? { |klass| params[:group_admins_can_reset_passwords].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: group_admins_can_set_user_password must be a single value, not #{params[:group_admins_can_set_user_password].class}") if [ Array, Hash ].any? { |klass| params[:group_admins_can_set_user_password].is_a?(klass) }
+      raise InvalidParameterError.new("Bad parameter: child_site_folder_admins_can_see_parent_site_directory must be a single value, not #{params[:child_site_folder_admins_can_see_parent_site_directory].class}") if [ Array, Hash ].any? { |klass| params[:child_site_folder_admins_can_see_parent_site_directory].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: bundle_recipient_blacklist_free_email_domains must be a single value, not #{params[:bundle_recipient_blacklist_free_email_domains].class}") if [ Array, Hash ].any? { |klass| params[:bundle_recipient_blacklist_free_email_domains].is_a?(klass) }
       raise InvalidParameterError.new("Bad parameter: bundle_recipient_blacklist_domains must be an Array") if !params[:bundle_recipient_blacklist_domains].nil? and !params[:bundle_recipient_blacklist_domains].is_a?(Array)
       raise InvalidParameterError.new("Bad parameter: admins_bypass_locked_subfolders must be a single value, not #{params[:admins_bypass_locked_subfolders].class}") if [ Array, Hash ].any? { |klass| params[:admins_bypass_locked_subfolders].is_a?(klass) }

metadata

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