haveapi-rust-client 0.30.1 → 0.30.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d48abd48b55a176accb7ff4492b9de2e68b6ee4b324d7edb406261387b467c4e
-  data.tar.gz: 2eb8481e97155eef2b0ad829b135ad504f880a29afea0a5b9e0c157229bb4ea5
+  metadata.gz: 96e9f24f598297eaaea7bce5ae34feaad34b8bb8db00af2c854602d686e5c267
+  data.tar.gz: 2671a364e42f99c7b44e704820c05653f999fb57844f289e09d7991ccfeb946e
 SHA512:
-  metadata.gz: 738bbd676ea82ff0a2eb25898c16a7038c5e8b25b54abaec838a8e1a25de08b248e92af70c355a886439f31572460eece27f8f96aed8630f945b95d554cba500
-  data.tar.gz: d0aa4952b7baf709927e4f95257ec8a42d72b672ca3f60fb048fcf8ca84f856fd0836a164101be162f69e12a4abaff2d6a4d2234f76e3d8e3d69c8e54d0ce837
+  metadata.gz: 821fb5d7d22dd75afe6b5dedbeff675ad7141873fda8af9c7da55b24cc394e2a26bbc96af10d0d1a425249e41d3b12218384d8cfe5f7cf4884826f12129caa73
+  data.tar.gz: 450823127999c9458b96607d7f25fae0ec4d49d38857f9d1d157f51aae4dee00ec900a940e2bf74e834a27e78d29b115435a988d80a0a5760bd1e76a35971a98

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../ruby
   specs:
-    haveapi-client (0.30.1)
+    haveapi-client (0.30.2)
       activesupport (>= 7.0)
       highline (~> 3.1)
       json
@@ -12,9 +12,9 @@ PATH
 PATH
   remote: .
   specs:
-    haveapi-rust-client (0.30.1)
+    haveapi-rust-client (0.30.2)
       fiddle (~> 1.1, >= 1.1.8)
-      haveapi-client (~> 0.30.1)
+      haveapi-client (~> 0.30.2)
       tomlrb (~> 2.0)
 
 GEM
@@ -137,6 +137,7 @@ PLATFORMS
 DEPENDENCIES
   haveapi-client!
   haveapi-rust-client!
+  json (= 2.21.2)
   rake
   rspec
   rubocop (~> 1.85.0)
@@ -155,8 +156,8 @@ CHECKSUMS
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
   fiddle (1.1.8) sha256=7fa8ee3627271497f3add5503acdbc3f40b32f610fc1cf49634f083ef3f32eee
   hana (1.3.7) sha256=5425db42d651fea08859811c29d20446f16af196308162894db208cac5ce9b0d
-  haveapi-client (0.30.1)
-  haveapi-rust-client (0.30.1)
+  haveapi-client (0.30.2)
+  haveapi-rust-client (0.30.2)
   highline (3.1.2) sha256=67cbd34d19f6ef11a7ee1d82ffab5d36dfd5b3be861f450fc1716c7125f4bb4a
   http-accept (1.7.0) sha256=c626860682bfbb3b46462f8c39cd470fd7b0584f61b3cc9df5b2e9eb9972a126
   http-cookie (1.1.6) sha256=ba4b82be64de61dc281243dac70e3c382c45142f20268ed9276a3670c93feaa9

data/docs/documentation.md

@@ -80,6 +80,20 @@ defaults, local paths and initialization diagnostics never enter rendered output
 See the [server profile guide](../../../doc/client-examples.md) for compatibility
 and rollback requirements.
 
+The adapter selects the action or advertised authentication provider from the
+current authorized description before normalizing that subtree. The private
+saved model resolves SDK names; it cannot establish authorization. Authentication
+still compares the complete supplied provider description with authorized help,
+and action rendering validates live routes and supplied parameter contracts.
+Symbol/string keys retain last-insertion collision behavior. No authorized
+description or rendering decision is cached across contexts or users.
+
+Normalization avoids unrelated resource descendants. Ancestor map lookup and
+saved-model action resolution can still depend on sibling/action counts. This
+does not make the complete render operation constant-time. Server context
+derivation shares unchanged owned data, while explicitly supplied resources,
+actions and samples still cross its copying boundary.
+
 The pure in-memory factories use the same resolve/render interface as legacy
 `Documentation.new(snapshot:, config:)`:
 
@@ -120,11 +134,21 @@ The pure adapter specs and server renderer bridge specs run before compilation:
 
 ```sh
 nix develop .#client-rust --command bash -c \
-  'cd clients/rust && bundle exec rspec spec/unit/documentation_spec.rb spec/unit/documentation_harness_spec.rb'
+  'cd clients/rust && bundle exec rspec spec/unit/documentation_spec.rb spec/unit/documentation_performance_spec.rb spec/unit/documentation_harness_spec.rb'
 nix develop .#server-ruby --command bash -c \
   'cd servers/ruby && bundle exec rspec spec/client_examples/rust_client_spec.rb'
 ```
 
+The performance unit specs count normalization work around real renders and
+check output/authorization parity as unrelated resource trees grow. They use no
+wall-clock budget. The opt-in [documentation benchmark](../../../doc/client-examples.md#documentation-benchmark)
+adds timing and allocation evidence. With server and Rust generator Ruby
+dependencies prepared, pass `--rust` through `BENCHMARK_DOCUMENTATION_ARGS` to
+include a matching profile in HTML and measure async/blocking adapter action and
+authentication rendering separately. These lanes do not generate or compile an
+SDK. Compare the same fixture, runtime, dependency inputs and output digests
+against both implementation revisions before claiming a measured improvement.
+
 The acceptance runner extracts actual `RustAsyncClient.render` and
 `RustBlockingClient.render` source. It generates a matching temporary fixture
 SDK, compiles the emitted imports, paths, methods and types, and executes the

data/lib/haveapi/rust_client/documentation.rb

@@ -116,6 +116,11 @@ module HaveAPI::RustClient
       end
     end
 
+    # Match normalize's last-insertion key semantics without visiting descendants.
+    def normalized_members(value)
+      value.is_a?(Hash) ? value.to_h { |key, item| [key.to_s, item] } : {}
+    end
+
     def program(context, mode, body, credentials: [])
       dependencies = dependency_lines(mode)
       dependencies << '// cargo add tokio --features macros,rt-multi-thread' if mode == :async
@@ -146,9 +151,13 @@ module HaveAPI::RustClient
 
     def authentication(context, mode, method, description)
       provider = method.to_s
-      live = normalize(context.description).fetch('authentication', {})[provider]
+      providers = normalized_members(context.description)['authentication']
+      live = normalized_members(providers)[provider]
       saved = @snapshot.fetch('description').fetch('authentication')[provider]
-      unsupported!('This authentication provider is unavailable in the authorized Rust SDK profile.') unless live && saved
+      unless live.is_a?(Hash) && saved
+        unsupported!('This authentication provider is unavailable in the authorized Rust SDK profile.')
+      end
+      live = normalize(live)
       unsupported!('The authentication description differs from the authorized help.') unless normalize(description) == live
 
       credentials = case provider
@@ -206,14 +215,16 @@ module HaveAPI::RustClient
     def action_credentials(action, context)
       return [] if action[:desc]['auth'] == false
 
-      live = normalize(context.description).fetch('authentication', {})
+      live = normalized_members(normalized_members(context.description)['authentication'])
       saved = @snapshot.fetch('description').fetch('authentication')
       if live.has_key?('basic') && saved.has_key?('basic')
         return ['.basic_auth(std::env::var("HAVEAPI_USER")?, std::env::var("HAVEAPI_PASSWORD")?)']
       end
 
       %w[token oauth2].each do |provider|
-        next unless live[provider] && saved[provider] && live[provider]['http_header'] == saved[provider]['http_header']
+        advertised = live[provider]
+        next unless advertised.is_a?(Hash) && saved[provider]
+        next unless normalize(normalized_members(advertised)['http_header']) == saved[provider]['http_header']
 
         setter = provider == 'token' ? 'token' : 'oauth2_token'
         return [".#{setter}(std::env::var(\"HAVEAPI_TOKEN\")?)"]
@@ -222,15 +233,16 @@ module HaveAPI::RustClient
     end
 
     def authorized_action(context)
-      resources = normalize(context.description).fetch('resources', {})
+      resources = normalized_members(context.description)['resources']
       resource = nil
       context.resource_path.each do |name|
-        resource = resources[name.to_s]
-        return nil unless resource
+        resource = normalized_members(resources)[name.to_s]
+        return nil unless resource.is_a?(Hash)
 
-        resources = resource.fetch('resources', {})
+        resources = normalized_members(resource)['resources']
       end
-      resource && resource.fetch('actions', {})[context.action_name.to_s]
+      action = normalized_members(normalized_members(resource)['actions'])[context.action_name.to_s]
+      normalize(action) if action.is_a?(Hash)
     end
 
     def compatible_action!(saved, live, context)

data/lib/haveapi/rust_client/version.rb

@@ -1,5 +1,5 @@
 module HaveAPI
   module RustClient
-    VERSION = '0.30.1'.freeze
+    VERSION = '0.30.2'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: haveapi-rust-client
 version: !ruby/object:Gem::Version
-  version: 0.30.1
+  version: 0.30.2
 platform: ruby
 authors:
 - Jakub Skokan
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.30.1
+        version: 0.30.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.30.1
+        version: 0.30.2
 - !ruby/object:Gem::Dependency
   name: tomlrb
   requirement: !ruby/object:Gem::Requirement