files.com 1.1.819 → 1.1.820

data/doc/Files/UserSecurityEvent.html

@@ -1858,7 +1858,7 @@ Each instance keeps its API field values in <code>attributes</code>.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:58 2026 by
+  Generated on Fri Nov  6 21:06:06 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/UserSftpClientUse.html

@@ -1262,7 +1262,7 @@ Each instance keeps its API field values in <code>attributes</code>.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:59 2026 by
+  Generated on Fri Nov  6 21:06:06 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/Util/LogSettings.html

@@ -301,7 +301,7 @@ standard output or error at <code>log_level</code> and above. A nil <code>log_le
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:30 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/Util.html

@@ -966,7 +966,7 @@ credentials, query, fragment, spaces or backslashes.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:30 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/WebDavActionLog.html

@@ -2359,7 +2359,7 @@ Each instance keeps its API field values in <code>attributes</code>.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:57 2026 by
+  Generated on Fri Nov  6 21:06:05 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/WebhookTest.html

@@ -3442,7 +3442,7 @@ Each instance keeps its API field values in <code>attributes</code>.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:46 2026 by
+  Generated on Fri Nov  6 21:05:57 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/Workspace.html

@@ -2894,7 +2894,7 @@ Each instance keeps its API field values in <code>attributes</code>.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:42 2026 by
+  Generated on Fri Nov  6 21:05:54 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/WriteAndBundlePermissionRequiredError.html

@@ -170,7 +170,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:31 2026 by
+  Generated on Fri Nov  6 21:05:45 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/WritePermissionRequiredError.html

@@ -170,7 +170,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:31 2026 by
+  Generated on Fri Nov  6 21:05:45 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files/ZipListEntry.html

@@ -579,7 +579,7 @@ Each instance keeps its API field values in <code>attributes</code>.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:54 2026 by
+  Generated on Fri Nov  6 21:06:03 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/Files.html

@@ -1725,7 +1725,7 @@ with API requests.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:29 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/_index.html

@@ -3263,7 +3263,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:29 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/file.README.html

@@ -1567,7 +1567,7 @@ reference locally. YARD is a development dependency; using the SDK does not
 require it. The normal <code>build.sh</code> also generates the reference. <code>bundle exec rake build</code> generates it before packaging and includes <code>doc/</code> in the gem.</p></div></div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:29 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/index.html

@@ -1567,7 +1567,7 @@ reference locally. YARD is a development dependency; using the SDK does not
 require it. The normal <code>build.sh</code> also generates the reference. <code>bundle exec rake build</code> generates it before packaging and includes <code>doc/</code> in the gem.</p></div></div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:29 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  6 20:20:29 2026 by
+  Generated on Fri Nov  6 21:05:44 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>

data/shared-functional-tests.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+require "bundler"
+Bundler.with_unbundled_env do
+  Dir.chdir(__dir__) do
+    mock = File.expand_path("../mock-server", Dir.pwd)
+    out = ENV.fetch("FILES_RUBY_FUNCTIONAL_OUT", File.expand_path("../../verification-ruby/manual-functional", Dir.pwd))
+    exit 1 unless system("ruby", File.join(mock, "with-scenario.rb"), "--scenario", "users-find", "--out", out,
+                         "--consumer-timeout", "60", "--", "bundle", "exec", "ruby", "test/test.rb", "--shared-simulator"
+    )
+    exit(system("bundle", "exec", "ruby", "test/test.rb", "--check-shared-simulator", out) ? 0 : 1)
+  end
+end

data/test/test.rb

@@ -1,15 +1,13 @@
-require '../lib/files.com'
+require_relative '../lib/files.com'
+require 'json'
+require 'net/http'
+require 'uri'
 require 'tempfile'
 
 def assert(value)
   raise "failed assertion" unless value
 end
 
-Files.api_key = File.read(File.expand_path("../../../.test_credentials", __dir__)).strip
-Files.base_url = "https://sdk.filesstaging.av"
-Files.logger = Logger.new($stdout)
-Files.log_level = 'debug'
-
 def test_user_list_and_update
   user = Files::User.all.first
   user = Files::User.find(user.id)
@@ -34,10 +32,10 @@ def test_folder_operations
   name = "folder_#{Time.now.to_i}"
   Files::Folder.create(name)
   file = Files::File.find(name)
-  file.copy("#{name}_copy")
+  file.copy(destination: "#{name}_copy")
   file.delete
   file = Files::File.find("#{name}_copy")
-  file.move("#{name}_moved_copy")
+  file.move(destination: "#{name}_moved_copy")
   file = Files::File.find("#{name}_moved_copy")
   Files::Folder.create("#{file.path}/child")
   Files::FileUtils.rm_r(file.path)
@@ -67,9 +65,74 @@ def test_sessions
   session.destroy
 end
 
-#test_user_list_and_update
-#test_user_create_and_delete
-#test_folder_operations
-#test_file_operations
-#test_file_ruby_emulation
-test_sessions
+# These existing manual functions exercise ordinary API behavior. Sessions remain a live/manual probe.
+FUNCTIONAL_TESTS = %w[test_user_list_and_update test_user_create_and_delete test_folder_operations test_file_operations test_file_ruby_emulation].freeze
+
+def simulator_control(origin, name, body = nil)
+  uri = URI("#{origin}/__files_mock/v1/#{name}")
+  response = Net::HTTP.start(uri.hostname, uri.port, nil, open_timeout: 5, read_timeout: 10) do |http|
+    body ? http.post(uri.request_uri, JSON.generate(body), "Content-Type" => "application/json") : http.get(uri.request_uri)
+  end
+  assert(response.code == "200")
+  JSON.parse(response.body)
+end
+
+case ARGV.first
+when "--shared-simulator"
+  assert(ARGV.size == 1)
+  names = %w[FILES_MOCK_SERVER_URL FILES_MOCK_SERVER_HOST FILES_MOCK_SERVER_PORT FILES_MOCK_SCHEMA_SHA256 FILES_MOCK_INSTANCE FILES_MOCK_API_KEY FILES_MOCK_SCENARIO_FILE FILES_MOCK_OUT]
+  env = names.to_h { |name| [ name, ENV.fetch(name) ] }
+  origin = env.fetch("FILES_MOCK_SERVER_URL")
+  assert(env.fetch("FILES_MOCK_SERVER_HOST") == "127.0.0.1")
+  port = Integer(env.fetch("FILES_MOCK_SERVER_PORT"))
+  assert(port.between?(1, 65_535) && origin == "http://127.0.0.1:#{port}")
+  assert(env.fetch("FILES_MOCK_API_KEY").match?(/\A[A-Za-z0-9]+\z/))
+  expected = { "status" => "ready", "mode" => "simulation", "contract_version" => 3,
+               "schema_sha256" => env.fetch("FILES_MOCK_SCHEMA_SHA256"), "instance" => env.fetch("FILES_MOCK_INSTANCE") }
+  scenario = JSON.parse(File.read(env.fetch("FILES_MOCK_SCENARIO_FILE")))
+  assert(scenario.fetch("name") == "users-find")
+  Files.api_key = env.fetch("FILES_MOCK_API_KEY")
+  Files.base_url = origin
+  Files.session_id = nil
+  Files.workspace_id = nil
+  results = FUNCTIONAL_TESTS.map do |name|
+    result = { "test" => name, "passed" => false }
+    begin
+      before = simulator_control(origin, "ready")
+      assert(before.slice(*expected.keys) == expected)
+      reset = simulator_control(origin, "reset", scenario.fetch("reset"))
+      after = simulator_control(origin, "ready")
+      assert(after.slice(*expected.keys) == expected && reset.fetch("epoch") == before.fetch("epoch") + 1 && after.fetch("epoch") == reset.fetch("epoch"))
+      send(name)
+      journal = simulator_control(origin, "journal")
+      assert(journal.fetch("epoch") == reset.fetch("epoch"))
+      assert(journal.fetch("complete") && journal.fetch("dropped").zero?)
+      ready = simulator_control(origin, "ready")
+      assert(ready.slice(*expected.keys) == expected && ready.fetch("epoch") == reset.fetch("epoch"))
+      calls = journal.fetch("entries").select { |entry| entry.fetch("path").start_with?("/api/rest/v1/") }
+      assert(!calls.empty? && calls.map { |entry| entry.dig("credentials", "api_key") }.uniq == [ 1 ])
+      File.write(File.join(env.fetch("FILES_MOCK_OUT"), "#{name}.journal.json"), JSON.pretty_generate(journal))
+      result["passed"] = true
+      result["epoch"] = reset.fetch("epoch")
+    rescue StandardError => e
+      result["error"] = "#{e.class}: #{e.message}"
+    end
+    result
+  end
+  File.write(File.join(env.fetch("FILES_MOCK_OUT"), "legacy-functional.json"), JSON.pretty_generate({ "tests" => results }))
+  results.each { |result| puts "#{result.fetch("test")}: #{result.fetch("passed") ? "passed" : result.fetch("error")}" }
+  exit(results.all? { |result| result.fetch("passed") } ? 0 : 1)
+when "--check-shared-simulator"
+  assert(ARGV.size == 2)
+  results = JSON.parse(File.read(File.join(ARGV.fetch(1), "legacy-functional.json"))).fetch("tests")
+  assert(results.size == 5 && results.map { |result| result.fetch("test") } == FUNCTIONAL_TESTS && results.all? { |result| result.fetch("passed") })
+  puts "All five legacy Ruby functional tests passed through the shared simulator."
+when nil
+  Files.api_key = File.read(File.expand_path("../../../.test_credentials", __dir__)).strip
+  Files.base_url = "https://sdk.filesstaging.av"
+  Files.logger = Logger.new($stdout)
+  Files.log_level = 'debug'
+  test_sessions
+else
+  abort "usage: test.rb [--shared-simulator | --check-shared-simulator OUT]"
+end

data/test.sh

@@ -3,6 +3,7 @@ require "bundler"
 Bundler.with_unbundled_env do
   Dir.chdir("generated/ruby") do
     exit 1 if ARGV[0] == "true" && !system("bundle install")
-    exit(system("bundle exec rspec") ? 0 : 1)
+    exit 1 unless system("bundle exec rspec")
+    exit(system("ruby", "shared-functional-tests.sh") ? 0 : 1)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.819
+  version: 1.1.820
 platform: ruby
 authors:
 - files.com
@@ -932,6 +932,7 @@ files:
 - lib/files.com/uri.rb
 - lib/files.com/util.rb
 - lib/files.com/version.rb
+- shared-functional-tests.sh
 - shared/comparison_examples.json
 - shared/header_test_data.json
 - shared/normalization_for_comparison_test_data.json