volcano-sdk 0.32.4 → 0.32.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ef8f141d5ef4704ebc727b5836e416fb382af153ad9eb7748ef9d77181c947f
-  data.tar.gz: 271d7a8647274d6229de1f89fae7521486bc8617c9f4caa9b37d69b859fc9e7f
+  metadata.gz: '00829ccc78685de8e0fb7fed50d6db137c861678c872b39a75eaba44e391e723'
+  data.tar.gz: 7b29d87a5bf1fc3b683620df34d76293c013f7c0dca361107b1045b2b5326cd4
 SHA512:
-  metadata.gz: 51b1d9f99ed3b506ae5716c89c29e558d5a7b3cd8b1d324a00c7adc05dc9d4c23753797c0d1d317d0f059a91574e461af32c15b9a37eefe4f43d9820db594b21
-  data.tar.gz: 60a608b1b29a3599abdcbc815c37a6f49073921eabdec82926f7f6c51024a1b3ca2f803d72b7c4256722955d5db9e7cc2d3dcba22b6005581bc7581019f54201
+  metadata.gz: 4c8376c90f0720047bc743b650657f7fc73289e103f57ddd7cb17beb3cdd8c085b6562c48b79967f60c789e6ca4ffa87b88a4ae70c1fec064d966d56342f18c1
+  data.tar.gz: 800f5bcc14498c14f08d3b6d96b1c9387fdf47cd51461749a38868417c1dfbea128c9390b71fcc2423176db287edb3f608afe1085b4b274046338dae17a09bb7

data/README.md

@@ -912,7 +912,7 @@ not a gem runtime dependency.
 Run `npm ci && bin/check-openapi` to verify generated provenance. Use
 `bundle exec rubocop -A` to apply safe formatting and lint fixes. Before
 changing the facade, run `bundle exec rubocop --parallel`, `bundle exec rspec`,
-and the shared Cucumber contract suite.
+and package checks. Hosting owns live acceptance for all SDKs.
 
 ## Contributing
 

data/lib/volcano/client.rb

@@ -3,7 +3,11 @@
 module Volcano
   # Entry point for Volcano API, storage, lock, and realtime operations.
   class Client
-    SessionToken = Data.define(:value) do
+    SessionToken = Data.define(:value)
+
+    # Restricts database queries to the captured access token.
+    class SessionToken
+      # @dynamic value
       def session_token = value
 
       def session_request
@@ -14,21 +18,27 @@ module Volcano
 
     attr_reader :auth, :functions, :durable, :logs, :storage, :locks, :realtime
 
-    def initialize(
+    # @dynamic auth, functions, durable, logs, storage, locks, realtime
+
+    def initialize( # rubocop:disable Metrics/ParameterLists -- Preserve typed constructor keywords.
       anon_key:,
       api_url: 'https://api.volcano.dev',
       service_key: nil,
       timeout: 60,
+      _transport: nil, # rubocop:disable Lint/UnderscorePrefixedVariableName -- Existing keyword API.
+      _realtime_socket_factory: nil, # rubocop:disable Lint/UnderscorePrefixedVariableName -- Existing keyword API.
+      _realtime_reconnect_delay: nil, # rubocop:disable Lint/UnderscorePrefixedVariableName -- Existing keyword API.
       **options
     )
       session = SessionCredentials.build(options.delete(:access_token), options.delete(:refresh_token))
-      transport, socket_factory, reconnect_delay = extract_adapters(options)
+      raise ArgumentError, "unknown keyword: #{options.keys.first}" unless options.empty?
+
       @api_url = api_url.delete_suffix('/')
       @anon_key = anon_key
       @service_key = service_key
       @auth_state = AuthState.new(session: session)
-      @transport = transport || GeneratedTransport.new(api_url: @api_url, timeout: timeout)
-      initialize_facades(socket_factory, reconnect_delay)
+      @transport = _transport || GeneratedTransport.new(api_url: @api_url, timeout: timeout)
+      initialize_facades(_realtime_socket_factory, _realtime_reconnect_delay)
     end
 
     def database(name)
@@ -57,9 +67,10 @@ module Volcano
     alias session_read session_request
 
     def service_token
-      raise Error::AuthenticationError, 'No service key configured' unless @service_key
+      service_key = @service_key
+      raise Error::AuthenticationError, 'No service key configured' unless service_key
 
-      @service_key
+      service_key
     end
 
     def function_token
@@ -100,19 +111,10 @@ module Volcano
 
     private
 
-    def database_with_token(name, token)
+    def database_with_token(name, token) # rubocop:disable Lint/UnusedPrivateMethod -- Typed cross-file private dispatch.
       Database.new(SessionToken.new(value: token), @transport, name)
     end
 
-    def extract_adapters(adapters)
-      transport = adapters.delete(:_transport)
-      socket_factory = adapters.delete(:_realtime_socket_factory)
-      reconnect_delay = adapters.delete(:_realtime_reconnect_delay)
-      raise ArgumentError, "unknown keyword: #{adapters.keys.first}" unless adapters.empty?
-
-      [transport, socket_factory, reconnect_delay]
-    end
-
     def initialize_facades(socket_factory, reconnect_delay)
       @auth = Auth.new(self, @transport, api_url: @api_url)
       @functions = Functions.new(self, @transport, api_url: @api_url)

data/lib/volcano/database.rb

@@ -140,7 +140,7 @@ module Volcano
     def query_body
       # @type var body: sdk_payload
       body = { 'table' => @table }
-      body.tap do |body|
+      body.tap do
         add_query_selection(body)
         body['limit'] = @limit unless @limit.nil?
         body['offset'] = @offset unless @offset.nil?

data/lib/volcano/durable_models.rb

@@ -39,9 +39,6 @@ module Volcano
 
   # Reopens the generated record for checked initialization.
   class DurableExecution
-    # @dynamic id, function_id, name, status, region, created_at, result, result_expired
-    # @dynamic error, completed_at, members, with, to_h, deconstruct, deconstruct_keys
-    # @dynamic self.[], self.members
     def initialize(**attributes)
       unknown = attributes.keys - DURABLE_EXECUTION_ATTRIBUTES
       raise ArgumentError, "unknown keywords: #{unknown.join(', ')}" unless unknown.empty?

data/lib/volcano/function_resolution.rb

@@ -115,7 +115,7 @@ module Volcano
 
       def usable_address?(uri)
         # URI accepts a port outside the range a connection can use.
-        !uri.host.to_s.empty? && uri.port.to_i.between?(1, 65_535)
+        !uri.host.to_s.empty? && (uri.port || 0).between?(1, 65_535)
       end
 
       def usable_scheme?(scheme, api_url)

data/lib/volcano/generated_transport.rb

@@ -5,7 +5,7 @@ require 'securerandom'
 require 'tempfile'
 require 'uri'
 
-generated_load_path = File.expand_path('generated/lib', __dir__)
+generated_load_path = File.expand_path('generated/lib', __dir__.to_s)
 $LOAD_PATH.unshift(generated_load_path) unless $LOAD_PATH.include?(generated_load_path)
 require 'volcano-generated'
 
@@ -17,8 +17,8 @@ end
 # Public namespace for the Volcano Ruby SDK.
 module Volcano
   private_constant :Generated
-  require_relative 'generated_transport_upload_session_api'
   require_relative 'generated_transport_support'
+  require_relative 'generated_transport_upload_session_api'
   require_relative 'generated_transport_auth'
   require_relative 'generated_transport_anonymous'
   require_relative 'generated_transport_confirmation'
@@ -35,7 +35,6 @@ module Volcano
   # Adapts the generated OpenAPI client to the stable SDK transport contract.
   class GeneratedTransport
     include ApiFactory
-    include LogTransport
     include ValueNormalization
 
     GeneratedApis = Data.define(
@@ -45,7 +44,7 @@ module Volcano
     def initialize(api_url:, timeout: 60, api_factory: nil)
       @api_url = api_url
       @timeout = timeout
-      @api_factory = api_factory || method(:build_apis)
+      @api_factory = api_factory || ->(authorization) { build_apis(authorization) }
     end
 
     def acquire_project_lock(authorization:, key:, ttl:, token:, request_id: SecureRandom.uuid)
@@ -112,7 +111,7 @@ module Volcano
     def invoke
       yield
     rescue Generated::ApiError => e
-      status = e.code.to_i
+      status = error_status(e)
       raise Error::TransportError.new(e.message), cause: e if status.zero?
 
       Transport::Response.new(
@@ -123,6 +122,10 @@ module Volcano
       )
     end
 
+    def error_status(error)
+      error.code.to_i # rubocop:disable Lint/NumberConversion -- Preserve generated ApiError status coercion.
+    end
+
     def response(data, status, headers, binary: nil)
       Transport::Response.new(
         status: status,

data/lib/volcano/generated_transport_anonymous.rb

@@ -7,11 +7,10 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthSignupAnonymousRequest.new(user_metadata: metadata)
-        response(
-          *apis.authentication.auth_signup_anonymous_with_http_info(
-            auth_signup_anonymous_request: request
-          )
+        data, status, headers = apis.authentication.auth_signup_anonymous_with_http_info(
+          auth_signup_anonymous_request: request
         )
+        response(data, status, headers)
       end
     end
 
@@ -19,12 +18,14 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         attributes = { email:, password:, user_metadata: metadata }
-        request = Generated::AuthSignupRequest.new(attributes)
+        request = Generated::AuthSignupRequest.new(email:, password:, user_metadata: metadata)
         body, status, headers = apis.authentication.auth_convert_anonymous_with_http_info(
           request,
           debug_body: attributes,
           debug_return_type: 'String'
         )
+        raise TypeError unless body.is_a?(String)
+
         response(JSON.parse(body), status, headers)
       end
     rescue JSON::ParserError, TypeError => e

data/lib/volcano/generated_transport_auth.rb

@@ -14,7 +14,8 @@ module Volcano
           password: password,
           user_metadata: metadata
         )
-        response(*apis.authentication.auth_signup_with_http_info(request))
+        data, status, headers = apis.authentication.auth_signup_with_http_info(request)
+        response(data, status, headers)
       end
     end
 
@@ -32,11 +33,10 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthForgotPasswordRequest.new(email: email)
-        response(
-          *apis.authentication.auth_forgot_password_with_http_info(
-            request, debug_return_type: 'String'
-          )
+        data, status, headers = apis.authentication.auth_forgot_password_with_http_info(
+          request, debug_return_type: 'String'
         )
+        response(data, status, headers)
       end
     end
 
@@ -44,11 +44,10 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthResetPasswordRequest.new(token:, new_password:)
-        response(
-          *apis.authentication.auth_reset_password_with_http_info(
-            request, debug_return_type: 'String'
-          )
+        data, status, headers = apis.authentication.auth_reset_password_with_http_info(
+          request, debug_return_type: 'String'
         )
+        response(data, status, headers)
       end
     end
 
@@ -58,6 +57,8 @@ module Volcano
         body, status, headers = apis.authentication.auth_get_user_with_http_info(
           debug_return_type: 'String'
         )
+        raise TypeError unless body.is_a?(String)
+
         response(JSON.parse(body), status, headers)
       end
     rescue JSON::ParserError, TypeError => e
@@ -67,9 +68,10 @@ module Volcano
     def auth_update_user(authorization:, password:, metadata:)
       invoke do
         apis = @api_factory.call(authorization)
-        body, status, headers = apis.authentication.auth_update_user_with_http_info(
-          **update_user_options(password:, metadata:)
-        )
+        options = update_user_options(password:, metadata:)
+        body, status, headers = apis.authentication.auth_update_user_with_http_info(options)
+        raise TypeError unless body.is_a?(String)
+
         response(JSON.parse(body), status, headers)
       end
     rescue JSON::ParserError, TypeError => e
@@ -80,7 +82,8 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthRefreshRequest.new(refresh_token: refresh_token)
-        response(*apis.authentication.auth_refresh_with_http_info(auth_refresh_request: request))
+        data, status, headers = apis.authentication.auth_refresh_with_http_info(auth_refresh_request: request)
+        response(data, status, headers)
       end
     end
 
@@ -88,16 +91,15 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthRefreshRequest.new(refresh_token: refresh_token)
-        response(*apis.authentication.auth_logout_with_http_info(auth_refresh_request: request))
+        data, status, headers = apis.authentication.auth_logout_with_http_info(auth_refresh_request: request)
+        response(data, status, headers)
       end
     end
 
     private
 
     def update_user_options(password:, metadata:)
-      attributes = {}
-      attributes[:password] = password unless password.nil?
-      attributes[:user_metadata] = metadata unless metadata.nil?
+      attributes = { password: password, user_metadata: metadata }.compact
       {
         auth_update_user_request: Generated::AuthUpdateUserRequest.new(attributes),
         debug_body: attributes,

data/lib/volcano/generated_transport_confirmation.rb

@@ -7,11 +7,10 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthConfirmEmailRequest.new(token:)
-        response(
-          *apis.authentication.auth_confirm_email_with_http_info(
-            request, debug_return_type: 'String'
-          )
+        data, status, headers = apis.authentication.auth_confirm_email_with_http_info(
+          request, debug_return_type: 'String'
         )
+        response(data, status, headers)
       end
     end
 
@@ -19,11 +18,10 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthForgotPasswordRequest.new(email:)
-        response(
-          *apis.authentication.auth_resend_confirmation_with_http_info(
-            request, debug_return_type: 'String'
-          )
+        data, status, headers = apis.authentication.auth_resend_confirmation_with_http_info(
+          request, debug_return_type: 'String'
         )
+        response(data, status, headers)
       end
     end
   end

data/lib/volcano/generated_transport_email_change.rb

@@ -14,6 +14,8 @@ module Volcano
           request,
           debug_return_type: 'String'
         )
+        raise TypeError unless data.is_a?(String)
+
         response(JSON.parse(data), status, headers)
       end
     rescue JSON::ParserError, TypeError => e
@@ -23,7 +25,8 @@ module Volcano
     def auth_cancel_email_change(authorization:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.authentication.auth_cancel_email_change_with_http_info)
+        data, status, headers = apis.authentication.auth_cancel_email_change_with_http_info
+        response(data, status, headers)
       end
     end
 
@@ -35,6 +38,8 @@ module Volcano
           request,
           debug_return_type: 'String'
         )
+        raise TypeError unless body.is_a?(String)
+
         response(JSON.parse(body), status, headers)
       end
     rescue JSON::ParserError, TypeError => e

data/lib/volcano/generated_transport_functions.rb

@@ -70,21 +70,28 @@ module Volcano
         function_id, request, follow_location: false, debug_return_type: 'String'
       )
     rescue Generated::ApiError => e
-      raise if e.code.to_i.zero?
+      status = error_status(e)
+      raise if status.zero?
 
-      [e.response_body, e.code.to_i, e.response_headers || {}]
+      [e.response_body, status, e.response_headers || {}]
     end
 
     def function_body(body, headers)
-      return nil if body.nil? || body.empty?
-
-      text = body.dup.force_encoding(Encoding::UTF_8).scrub.delete_prefix("\uFEFF")
-      return nil if text.empty?
+      text = normalized_function_text(body)
+      return nil if text.nil? || text.empty?
       return text unless function_json?(text, headers)
 
       parse_function_json(text)
     end
 
+    def normalized_function_text(body)
+      raise TypeError, 'Expected a string function response' unless body.nil? || body.is_a?(String)
+
+      return nil if body.nil? || body.empty?
+
+      body.dup.force_encoding(Encoding::UTF_8).scrub.delete_prefix("\uFEFF")
+    end
+
     def parse_function_json(text)
       parsed = JSON.parse(text)
       valid_function_encoding?(parsed) ? parsed : text

data/lib/volcano/generated_transport_logs.rb

@@ -1,31 +1,28 @@
 # frozen_string_literal: true
 
 module Volcano
+  # Logs operations backed by the generated API client.
   class GeneratedTransport
-    # Generated OpenAPI operations used by the public logs facade.
-    module LogTransport
-      def search_project_logs(authorization:, project_id:, request:)
-        invoke do
-          apis = @api_factory.call(authorization)
-          body = Generated::LogSearchRequest.new(deep_symbolize(request))
-          data, status, headers = apis.logs.search_project_logs_with_http_info(
-            project_id, body, debug_return_type: 'String'
-          )
-          response(parse_body(data), status, headers)
-        end
+    def search_project_logs(authorization:, project_id:, request:)
+      invoke do
+        apis = @api_factory.call(authorization)
+        body = Generated::LogSearchRequest.new(deep_symbolize(request))
+        data, status, headers = apis.logs.search_project_logs_with_http_info(
+          project_id, body, debug_return_type: 'String'
+        )
+        response(parse_body(data), status, headers)
       end
+    end
 
-      def get_project_log_activity(authorization:, project_id:, request:)
-        invoke do
-          apis = @api_factory.call(authorization)
-          body = Generated::LogActivityRequest.new(deep_symbolize(request))
-          data, status, headers = apis.logs.get_project_log_activity_with_http_info(
-            project_id, body, debug_return_type: 'String'
-          )
-          response(parse_body(data), status, headers)
-        end
+    def get_project_log_activity(authorization:, project_id:, request:)
+      invoke do
+        apis = @api_factory.call(authorization)
+        body = Generated::LogActivityRequest.new(deep_symbolize(request))
+        data, status, headers = apis.logs.get_project_log_activity_with_http_info(
+          project_id, body, debug_return_type: 'String'
+        )
+        response(parse_body(data), status, headers)
       end
     end
-    private_constant :LogTransport
   end
 end

data/lib/volcano/generated_transport_oauth.rb

@@ -4,52 +4,61 @@ module Volcano
   # OAuth operations for the internal generated transport.
   class GeneratedTransport
     def auth_oauth_authorization_url(anon_key:, provider:, redirect_url:, client_state:)
-      oauth_authorization_api.auth_o_auth_authorize_with_http_info(
+      url = oauth_authorization_api.auth_o_auth_authorize_with_http_info(
         provider, anon_key,
         redirect_url:, client_state:, response_mode: 'code'
       ).first
+      raise TypeError, 'Expected OAuth authorization URL' unless url.is_a?(String)
+
+      url
     end
 
     def auth_oauth_exchange(authorization:, code:, redirect_url:)
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::AuthOAuthExchangeRequest.new(code:, redirect_url:)
-        response(*apis.oauth.auth_o_auth_exchange_with_http_info(request))
+        data, status, headers = apis.oauth.auth_o_auth_exchange_with_http_info(request)
+        response(data, status, headers)
       end
     end
 
     def auth_link_oauth_provider(authorization:, provider:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.oauth.auth_link_o_auth_provider_with_http_info(provider))
+        data, status, headers = apis.oauth.auth_link_o_auth_provider_with_http_info(provider)
+        response(data, status, headers)
       end
     end
 
     def auth_list_oauth_providers(authorization:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.oauth.auth_list_o_auth_providers_with_http_info)
+        data, status, headers = apis.oauth.auth_list_o_auth_providers_with_http_info
+        response(data, status, headers)
       end
     end
 
     def auth_unlink_oauth_provider(authorization:, provider:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.oauth.auth_unlink_o_auth_provider_with_http_info(provider))
+        data, status, headers = apis.oauth.auth_unlink_o_auth_provider_with_http_info(provider)
+        response(data, status, headers)
       end
     end
 
     def auth_get_oauth_provider_token(authorization:, provider:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.oauth.get_o_auth_provider_token_with_http_info(provider))
+        data, status, headers = apis.oauth.get_o_auth_provider_token_with_http_info(provider)
+        response(data, status, headers)
       end
     end
 
     def auth_refresh_oauth_provider_token(authorization:, provider:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.oauth.refresh_o_auth_provider_token_with_http_info(provider))
+        data, status, headers = apis.oauth.refresh_o_auth_provider_token_with_http_info(provider)
+        response(data, status, headers)
       end
     end
 
@@ -57,7 +66,8 @@ module Volcano
       invoke do
         apis = @api_factory.call(authorization)
         request = Generated::CallOAuthProviderAPIRequest.new(endpoint:, method:, body:)
-        response(*apis.oauth.call_o_auth_provider_api_with_http_info(provider, request))
+        data, status, headers = apis.oauth.call_o_auth_provider_api_with_http_info(provider, request)
+        response(data, status, headers)
       end
     end
   end

data/lib/volcano/generated_transport_sessions.rb

@@ -6,21 +6,24 @@ module Volcano
     def auth_get_my_sessions(authorization:, page:, limit:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.authentication.auth_get_my_sessions_with_http_info(page: page, limit: limit))
+        data, status, headers = apis.authentication.auth_get_my_sessions_with_http_info(page: page, limit: limit)
+        response(data, status, headers)
       end
     end
 
     def auth_delete_all_my_sessions(authorization:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.authentication.auth_delete_all_my_sessions_with_http_info)
+        data, status, headers = apis.authentication.auth_delete_all_my_sessions_with_http_info
+        response(data, status, headers)
       end
     end
 
     def auth_delete_my_session(authorization:, session_id:)
       invoke do
         apis = @api_factory.call(authorization)
-        response(*apis.authentication.auth_delete_my_session_with_http_info(session_id))
+        data, status, headers = apis.authentication.auth_delete_my_session_with_http_info(session_id)
+        response(data, status, headers)
       end
     end
   end

data/lib/volcano/generated_transport_storage.rb

@@ -10,7 +10,7 @@ module Volcano
           options = { content_type: content_type }.compact
           result = apis.storage.upload_storage_object_with_http_info(bucket_name, path, file, options)
           data_value, status, headers = result
-          return response(data_value, status, headers)
+          response(data_value, status, headers)
         end
       end
     end

data/lib/volcano/generated_transport_support.rb

@@ -16,11 +16,12 @@ module Volcano
       private
 
       def deserialize_private_model(klass, value)
-        if klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of)
-          klass.build(value)
-        else
-          klass.build_from_hash(value)
-        end
+        method_name = if klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of)
+                        :build
+                      else
+                        :build_from_hash
+                      end
+        klass.method(method_name).call(value)
       end
     end
     private_constant :ModelDeserialization
@@ -64,8 +65,7 @@ module Volcano
 
     # Implements storage endpoints omitted by the generated API surface.
     class StorageApi < Generated::StorageObjectsApi
-      include UploadSessionStorageApi
-
+      DOWNLOAD_HEADERS = { 'Accept' => 'application/octet-stream, application/json' }.freeze
       UPLOAD_OPTIONS = {
         operation: :'StorageObjectsApi.upload_storage_object',
         header_params: { 'Accept' => 'application/json', 'Content-Type' => 'multipart/form-data' }.freeze,
@@ -74,7 +74,7 @@ module Volcano
       }.freeze
       DOWNLOAD_OPTIONS = {
         operation: :'StorageObjectsApi.download_storage_object',
-        header_params: { 'Accept' => 'application/octet-stream, application/json' }.freeze,
+        header_params: DOWNLOAD_HEADERS,
         auth_names: %w[ServiceRoleKey AuthUserAccessToken AnonKey].freeze,
         return_type: 'File'
       }.freeze
@@ -101,7 +101,10 @@ module Volcano
       end
 
       def download_storage_object_with_http_info(bucket_name, path, opts = {})
-        header_params = DOWNLOAD_OPTIONS.fetch(:header_params).merge(opts[:header_params] || {})
+        provided_headers = opts[:header_params]
+        raise TypeError, 'Invalid storage headers' unless provided_headers.nil? || provided_headers.is_a?(Hash)
+
+        header_params = DOWNLOAD_HEADERS.merge(provided_headers || {})
         header_params['Range'] = opts[:range] unless opts[:range].nil?
         options = opts.merge(DOWNLOAD_OPTIONS, header_params: header_params)
 
@@ -134,15 +137,19 @@ module Volcano
       private
 
       def parse_body(value)
-        return {} if value.nil? || value.empty?
+        # @type var empty_body: Hash[String, Object?]
+        empty_body = {}
+        return empty_body if value.nil?
+        raise TypeError, 'Expected a string response body' unless value.is_a?(String)
+        return empty_body if value.empty?
 
         JSON.parse(value)
       rescue JSON::ParserError
-        {}
+        empty_body
       end
 
       def plain_value(value)
-        value = value.to_hash if value.respond_to?(:to_hash)
+        value = value.method(:to_hash).call if value.respond_to?(:to_hash)
         case value
         when Hash then plain_hash(value)
         when Array then value.map { |item| plain_value(item) }
@@ -155,9 +162,13 @@ module Volcano
       end
 
       def deep_symbolize(value)
+        value.to_h { |key, item| [key.to_sym, deep_symbolize_value(item)] }
+      end
+
+      def deep_symbolize_value(value)
         case value
-        when Hash then value.to_h { |key, item| [key.to_sym, deep_symbolize(item)] }
-        when Array then value.map { |item| deep_symbolize(item) }
+        when Hash then deep_symbolize(value)
+        when Array then value.map { |item| deep_symbolize_value(item) }
         else value
         end
       end
@@ -166,19 +177,24 @@ module Volcano
         return value.to_s.b unless value.respond_to?(:read)
 
         prepare_stream(value)
-        value.read.b
+        result = value.method(:read).call
+        raise TypeError, 'Expected a binary stream' unless result.is_a?(String)
+
+        result.b
       ensure
-        value.close! if value.respond_to?(:close!)
+        value.method(:close!).call if value.respond_to?(:close!)
       end
 
       def prepare_stream(value)
         reopen_stream(value)
-        value.binmode if value.respond_to?(:binmode)
-        value.rewind if value.respond_to?(:rewind)
+        value.method(:binmode).call if value.respond_to?(:binmode)
+        value.method(:rewind).call if value.respond_to?(:rewind)
       end
 
       def reopen_stream(value)
-        value.open if value.respond_to?(:closed?) && value.closed? && value.respond_to?(:open)
+        return unless value.respond_to?(:closed?) && value.method(:closed?).call && value.respond_to?(:open)
+
+        value.method(:open).call
       end
     end
 
@@ -192,11 +208,12 @@ module Volcano
       end
 
       def generated_configuration(authorization)
-        uri = URI(@api_url)
+        uri = URI.parse(@api_url)
+        path = uri.path || ''
         Generated::Configuration.new.tap do |configuration|
           configuration.scheme = uri.scheme
           configuration.host = host_with_port(uri)
-          configuration.base_path = uri.path == '/' ? '' : uri.path
+          configuration.base_path = path == '/' ? '' : path
           configuration.ignore_operation_servers = true
           configuration.access_token = authorization
           configuration.timeout = timeout_milliseconds
@@ -226,9 +243,11 @@ module Volcano
       end
 
       def host_with_port(uri)
-        return uri.host if uri.port == uri.default_port
+        host = uri.host
+        raise ArgumentError, 'API URL requires a host' unless host
+        return host if uri.port == uri.default_port
 
-        "#{uri.host}:#{uri.port}"
+        "#{host}:#{uri.port}"
       end
     end
   end

data/lib/volcano/generated_transport_upload_session_api.rb

@@ -2,7 +2,11 @@
 
 module Volcano
   # Corrects generated HTTP operations for resumable storage uploads.
-  module UploadSessionStorageApi
+  class GeneratedTransport::StorageApi
+    UPLOAD_PART_HEADERS = { 'Accept' => 'application/json', 'Content-Type' => 'application/octet-stream' }.freeze
+    COMPLETE_HEADERS = { 'Accept' => 'application/json', 'Content-Type' => 'application/json' }.freeze
+    STATUS_HEADERS = { 'Accept' => 'application/json' }.freeze
+    ABORT_HEADERS = { 'Accept' => 'application/json' }.freeze
     CREATE_OPTIONS = {
       operation: :'StorageObjectsApi.upload_storage_object',
       header_params: { 'Accept' => 'application/json', 'Content-Type' => 'application/json' }.freeze,
@@ -11,25 +15,25 @@ module Volcano
     }.freeze
     UPLOAD_PART_OPTIONS = {
       operation: :'StorageObjectsApi.upload_part',
-      header_params: { 'Accept' => 'application/json', 'Content-Type' => 'application/octet-stream' }.freeze,
+      header_params: UPLOAD_PART_HEADERS,
       auth_names: %w[ServiceRoleKey AuthUserAccessToken AnonKey].freeze,
       return_type: 'UploadSessionPart'
     }.freeze
     COMPLETE_OPTIONS = {
       operation: :'StorageObjectsApi.upload_storage_object',
-      header_params: { 'Accept' => 'application/json', 'Content-Type' => 'application/json' }.freeze,
+      header_params: COMPLETE_HEADERS,
       auth_names: %w[ServiceRoleKey AuthUserAccessToken AnonKey].freeze,
       return_type: 'CompleteUploadSessionResponse'
     }.freeze
     STATUS_OPTIONS = {
       operation: :'StorageObjectsApi.download_storage_object',
-      header_params: { 'Accept' => 'application/json' }.freeze,
+      header_params: STATUS_HEADERS,
       auth_names: %w[ServiceRoleKey AuthUserAccessToken AnonKey].freeze,
       return_type: 'UploadSessionStatusResponse'
     }.freeze
     ABORT_OPTIONS = {
       operation: :'StorageObjectsApi.delete_storage_object',
-      header_params: { 'Accept' => 'application/json' }.freeze,
+      header_params: ABORT_HEADERS,
       auth_names: %w[ServiceRoleKey AuthUserAccessToken].freeze
     }.freeze
 
@@ -39,7 +43,7 @@ module Volcano
     end
 
     def upload_part_with_http_info(bucket_name, path, session_id, part_number, data)
-      headers = UPLOAD_PART_OPTIONS.fetch(:header_params).merge(
+      headers = UPLOAD_PART_HEADERS.merge(
         'X-Upload-Session' => session_id, 'X-Part-Number' => part_number.to_s
       )
       call_storage_api(
@@ -48,22 +52,21 @@ module Volcano
     end
 
     def complete_upload_session_with_http_info(bucket_name, path, session_id)
-      headers = COMPLETE_OPTIONS.fetch(:header_params).merge(
+      headers = COMPLETE_HEADERS.merge(
         'X-Upload-Session' => session_id, 'X-Upload-Complete' => 'true'
       )
-      options = COMPLETE_OPTIONS.merge(header_params: headers, body: JSON.generate({}))
+      options = COMPLETE_OPTIONS.merge(header_params: headers, body: '{}')
       call_storage_api(:POST, bucket_name, path, options)
     end
 
     def get_upload_session_with_http_info(bucket_name, path, session_id)
-      headers = STATUS_OPTIONS.fetch(:header_params).merge('X-Upload-Session' => session_id)
+      headers = STATUS_HEADERS.merge('X-Upload-Session' => session_id)
       call_storage_api(:GET, bucket_name, path, STATUS_OPTIONS.merge(header_params: headers))
     end
 
     def abort_upload_session_with_http_info(bucket_name, path, session_id)
-      headers = ABORT_OPTIONS.fetch(:header_params).merge('X-Upload-Session' => session_id)
+      headers = ABORT_HEADERS.merge('X-Upload-Session' => session_id)
       call_storage_api(:DELETE, bucket_name, path, ABORT_OPTIONS.merge(header_params: headers))
     end
   end
-  private_constant :UploadSessionStorageApi
 end

data/lib/volcano/lock_guard.rb

@@ -14,7 +14,7 @@ module Volcano
     def initialize(lease, ttl:, started_at:)
       @lease = lease
       @ttl = ttl
-      @lease_clock = LockLeaseClock.new(ttl: ttl, started_at: started_at)
+      @lease_clock = LockLeaseClock.new(ttl: ttl, started_at: started_at) # rubocop:disable Lint/NameTypo -- Inherited Class#new.
       @mutex = Mutex.new
       @changed = ConditionVariable.new
       @failure = nil

data/lib/volcano/models.rb

@@ -11,10 +11,6 @@ module Volcano
 
   # Reopens the generated record for checked initialization.
   class AuthSession
-    # @dynamic id, user_id, provider, expires_at, is_active, is_current, user_agent
-    # @dynamic ip_address, last_ip_address, last_activity_at, session_started_at
-    # @dynamic created_at, updated_at, members, with, to_h, deconstruct
-    # @dynamic deconstruct_keys, self.[], self.members
     def initialize(**attributes)
       unknown = attributes.keys - AUTH_SESSION_ATTRIBUTES
       raise ArgumentError, "unknown keywords: #{unknown.join(', ')}" unless unknown.empty?
@@ -51,8 +47,6 @@ module Volcano
 
   # Reopens the generated record for checked initialization.
   class LinkedOAuthProvider
-    # @dynamic provider, linked_at, updated_at, members, with, to_h, deconstruct
-    # @dynamic deconstruct_keys, self.[], self.members
     def initialize(provider:, linked_at:, updated_at:)
       provider = immutable_value(provider)
       linked_at = immutable_value(linked_at)

data/lib/volcano/realtime/connection.rb

@@ -99,7 +99,9 @@ module Volcano
       def open_socket(address)
         require 'async/http/endpoint'
         require 'async/websocket/client'
-        Async::WebSocket::Client.connect(Async::HTTP::Endpoint.parse(address))
+        # Use the HTTP/1.1 upgrade supported by the public API.
+        endpoint = Async::HTTP::Endpoint.parse(address, protocol: Async::HTTP::Protocol::HTTP11)
+        Async::WebSocket::Client.connect(endpoint)
       end
 
       def realtime_secrets = [@client.anon_token, @client.current_session&.access_token]

data/lib/volcano/realtime/postgres_changes.rb

@@ -8,8 +8,6 @@ module Volcano
 
     # Immutable snapshot of a Postgres change publication.
     class PostgresChange
-      # @dynamic type, schema, table, record, old_record, columns, timestamp, id, mode
-      # @dynamic members, with, to_h, deconstruct, deconstruct_keys, self.[], self.members
       def initialize(type:, schema:, table:, timestamp:, **payload)
         type = Immutable.call(type.to_s)
         schema = Immutable.call(schema.to_s)

data/lib/volcano/realtime.rb

@@ -189,8 +189,6 @@ module Volcano
 
       attr_reader :name
 
-      # @dynamic name
-
       def initialize(realtime, protocol_provider, name, type, batch_config:)
         @realtime = realtime
         @protocol_provider = protocol_provider

data/lib/volcano/session.rb

@@ -5,7 +5,7 @@ require 'time'
 
 module Volcano
   SESSION_USER_CODER = JSON::Coder.new(freeze: true, allow_duplicate_key: false) do |value|
-    value.instance_of?(Time) ? Time.at(value.to_r).utc.iso8601(9) : value
+    value.instance_of?(Time) ? Time.at(Rational(value)).utc.iso8601(9) : value
   end
   private_constant :SESSION_USER_CODER
 
@@ -14,8 +14,6 @@ module Volcano
 
   # Reopens the generated record for checked initialization.
   class Session
-    # @dynamic access_token, refresh_token, user_id, user, members, with, to_h
-    # @dynamic deconstruct, deconstruct_keys, self.[], self.members
     def initialize(access_token:, refresh_token: nil, user_id: nil, user: nil)
       user = immutable_user(user)
       super

data/lib/volcano/storage_models.rb

@@ -10,9 +10,6 @@ module Volcano
 
   # Validates and freezes object metadata returned by storage.
   class StorageObject
-    # @dynamic id, bucket_id, name, size, mime_type, is_public, owner_id, etag
-    # @dynamic metadata, created_at, updated_at, public_url
-    # @dynamic members, with, to_h, deconstruct, deconstruct_keys, self.[], self.members
     def initialize(**attributes)
       unknown = attributes.keys - STORAGE_OBJECT_ATTRIBUTES
       raise ArgumentError, "unknown keywords: #{unknown.join(', ')}" unless unknown.empty?

data/lib/volcano/storage_upload_models.rb

@@ -76,9 +76,6 @@ module Volcano
 
   # Freezes upload progress returned by storage.
   class UploadSessionStatus
-    # @dynamic session_id, status, path, content_type, total_size, part_size
-    # @dynamic total_parts, parts_uploaded, bytes_uploaded, parts, expires_at, created_at
-    # @dynamic members, with, to_h, deconstruct, deconstruct_keys, self.[], self.members
     def initialize(**attributes)
       unknown = attributes.keys - UPLOAD_SESSION_STATUS_ATTRIBUTES
       raise ArgumentError, "unknown keywords: #{unknown.join(', ')}" unless unknown.empty?

data/lib/volcano/transport.rb

@@ -52,45 +52,6 @@ module Volcano
       message.is_a?(String) ? message : 'Volcano request failed'
     end
 
-    def self.json_value(value)
-      case value
-      when Array then value.map { |entry| json_value(entry) }
-      when Hash then json_object(value)
-      else json_scalar(value)
-      end
-    end
-
-    def self.json_object(value, message: 'Expected a JSON object')
-      raise TypeError, message unless value.is_a?(Hash)
-
-      value.to_h do |key, item|
-        raise TypeError, message unless key.is_a?(String)
-
-        [key, json_value(item)]
-      end
-    end
-
-    def self.json_rows(value)
-      rows = json_object(value)['data']
-      raise TypeError, 'Expected database rows' unless rows.is_a?(Array)
-
-      rows.map { |row| json_object(row) }
-    end
-
-    def self.finite_float(value)
-      raise TypeError, 'Expected a finite JSON number' unless value.finite?
-
-      value
-    end
-
-    def self.json_scalar(value)
-      case value
-      when NilClass, TrueClass, FalseClass, Integer, String then value
-      when Float then finite_float(value)
-      else raise TypeError, 'Expected a JSON response'
-      end
-    end
-
     def self.error_type(status)
       ERROR_TYPES.fetch(status) do
         status.between?(500, 599) ? Error::ServerError : Error::VolcanoError
@@ -101,6 +62,8 @@ module Volcano
       value = headers&.find { |key, _| key.casecmp?(name) }&.last
       Integer(value, exception: false)
     end
-    private_class_method :error_type, :integer_header, :response_error, :finite_float, :json_scalar
+    private_class_method :error_type, :integer_header, :response_error
   end
 end
+
+require_relative 'transport_json'

data/lib/volcano/transport_json.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Volcano
+  # Validates and copies JSON response values from function and database transports.
+  module Transport
+    def self.json_value(value)
+      # @type var active: Hash[Integer, bool]
+      active = {}
+      copy = json_copy(value, active)
+      validate_json_encoding(copy)
+      copy
+    end
+
+    def self.json_copy(value, active)
+      case value
+      when Array then json_container(value, active) { value.map { |entry| json_copy(entry, active) } }
+      when Hash then json_hash(value, active, message: 'Expected a JSON object')
+      else json_scalar(value)
+      end
+    end
+
+    def self.json_object(value, message: 'Expected a JSON object')
+      # @type var active: Hash[Integer, bool]
+      active = {}
+      copy = json_hash(value, active, message:)
+      validate_json_encoding(copy)
+      copy
+    end
+
+    def self.json_hash(value, active, message:)
+      raise TypeError, message unless value.is_a?(Hash)
+
+      json_container(value, active) do
+        value.to_h do |key, item|
+          raise TypeError, message unless key.is_a?(String)
+
+          [key, json_copy(item, active)]
+        end
+      end
+    end
+
+    def self.json_container(value, active)
+      id = value.object_id
+      raise TypeError, 'Expected a JSON response' if active.key?(id) || active.size >= 100
+
+      active[id] = true
+      copy = yield
+      active.delete(id)
+      copy
+    end
+
+    def self.validate_json_encoding(value)
+      JSON.generate(value)
+      nil
+    rescue JSON::GeneratorError
+      raise TypeError, 'Expected a JSON response', cause: nil
+    end
+
+    def self.json_rows(value)
+      rows = json_object(value)['data']
+      raise TypeError, 'Expected database rows' unless rows.is_a?(Array)
+
+      rows.map { |row| json_object(row) }
+    end
+
+    def self.finite_float(value)
+      raise TypeError, 'Expected a finite JSON number' unless value.finite?
+
+      value
+    end
+
+    def self.json_scalar(value)
+      case value
+      when NilClass, TrueClass, FalseClass, Integer, String then value
+      when Float then finite_float(value)
+      else raise TypeError, 'Expected a JSON response'
+      end
+    end
+
+    private_class_method :json_copy, :json_hash, :json_container, :validate_json_encoding, :finite_float, :json_scalar
+  end
+end

data/lib/volcano/user.rb

@@ -14,9 +14,6 @@ module Volcano
 
   # Reopens the generated record for checked initialization.
   class User
-    # @dynamic id, project_id, email, email_confirmed, user_metadata, app_metadata
-    # @dynamic avatar_url, status, banned_until, last_sign_in_at, created_at, updated_at
-    # @dynamic members, with, to_h, deconstruct, deconstruct_keys, self.[], self.members
     def initialize(id:, email:, status:, **attributes)
       validate_optional_attributes(attributes)
       id = freeze_value(id)

data/lib/volcano/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Volcano
-  VERSION = '0.32.4'
+  VERSION = '0.32.6'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: volcano-sdk
 version: !ruby/object:Gem::Version
-  version: 0.32.4
+  version: 0.32.6
 platform: ruby
 authors:
 - Kong
@@ -613,6 +613,7 @@ files:
 - lib/volcano/storage_upload_models.rb
 - lib/volcano/storage_upload_sessions.rb
 - lib/volcano/transport.rb
+- lib/volcano/transport_json.rb
 - lib/volcano/user.rb
 - lib/volcano/version.rb
 - sig/auth_credentials.rbs