authlete_ruby_sdk 0.0.2.beta → 0.0.5.pre.beta

data/lib/crystalline/module.rb

@@ -4,11 +4,16 @@
 # frozen_string_literal: true
 
 module Crystalline
+  @union_strategy = :left_to_right
+
+  class << self
+    attr_accessor :union_strategy
+  end
 
   def self.to_dict(complex)
-    if complex.is_a? Array
+    if complex.is_a? ::Array
       complex.map { |v| Crystalline.to_dict(v) }
-    elsif complex.is_a? Hash
+    elsif complex.is_a? ::Hash
       complex.transform_values { |v| Crystalline.to_dict(v) }
     elsif complex.respond_to?(:class) && complex.class.include?(::Crystalline::MetadataFields)
       complex.to_dict
@@ -29,21 +34,18 @@ module Crystalline
     if Crystalline::Utils.nilable? type
       type = Crystalline::Utils.nilable_of type
     end
-    if type.instance_of?(Class) && type.include?(::Crystalline::MetadataFields)
+    if type.is_a?(Crystalline::DiscriminatedUnion)
+      type.parse(data)
+    elsif type.instance_of?(Class) && type.include?(::Crystalline::MetadataFields)
       type.from_dict(data)
     elsif Crystalline::Utils.union? type
       union_types = Crystalline::Utils.get_union_types(type)
       union_types = union_types.sort_by { |klass| Crystalline.non_nilable_attr_count(klass) }
 
-      union_types.each do |union_type|
-        unmarshalled_val = Crystalline.unmarshal_json(data, union_type)
-        return unmarshalled_val
-      rescue TypeError
-        next
-      rescue NoMethodError
-        next
-      rescue KeyError
-        next
+      if Crystalline.union_strategy == :populated_fields
+        Crystalline.unmarshal_union_populated_fields(data, union_types)
+      else
+        Crystalline.unmarshal_union_left_to_right(data, union_types)
       end
     elsif Crystalline::Utils.arr? type
       data.map { |v| Crystalline.unmarshal_json(v, Crystalline::Utils.arr_of(type)) }
@@ -55,6 +57,8 @@ module Crystalline
       Crystalline::Utils.to_boolean(data)
     elsif type.is_a?(Class) && type < T::Enum
       type.deserialize(data)
+    elsif type.is_a?(Class) && type.respond_to?(:enums) && type.respond_to?(:deserialize)
+      type.deserialize(data)
     else
       data
     end
@@ -64,7 +68,7 @@ module Crystalline
     if val.class.respond_to? :enums
       val.serialize
     elsif val.is_a? DateTime
-      val.strftime('%Y-%m-%dT%H:%M:%S.%NZ')
+      val.strftime('%Y-%m-%dT%H:%M:%S.%NZ').sub(/(\.\d*[1-9])0+Z\z/, '\1Z').sub(/\.0+Z\z/, 'Z')
     elsif val.nil?
       nil
     elsif primitives
@@ -74,6 +78,88 @@ module Crystalline
     end
   end
 
+  def self.unmarshal_union_left_to_right(data, union_types)
+    union_types.each do |union_type|
+      return Crystalline.unmarshal_json(data, union_type)
+    rescue TypeError
+      next
+    rescue NoMethodError
+      next
+    rescue KeyError
+      next
+    end
+    nil
+  end
+
+  def self.unmarshal_union_populated_fields(data, union_types)
+    best_value = nil
+    best_matched = -1
+    best_inexact = 0
+    best_unmatched = 0
+
+    union_types.each do |union_type|
+      value = Crystalline.unmarshal_json(data, union_type)
+      matched, inexact, unmatched = count_matched_fields(value, data)
+
+      if best_value.nil? ||
+         matched > best_matched ||
+         (matched == best_matched && inexact < best_inexact) ||
+         (matched == best_matched && inexact == best_inexact && unmatched < best_unmatched)
+        best_value = value
+        best_matched = matched
+        best_inexact = inexact
+        best_unmatched = unmatched
+      end
+    rescue TypeError
+      next
+    rescue NoMethodError
+      next
+    rescue KeyError
+      next
+    end
+    best_value
+  end
+
+  def self.count_matched_fields(value, raw_data)
+    matched = 0
+    inexact = 0
+    unmatched = 0
+
+    if value.is_a?(Crystalline::Unknown)
+      return [0, 0, 0]
+    elsif value.class.include?(::Crystalline::MetadataFields)
+      value.fields.each do |field|
+        format_metadata = field.metadata.fetch(:format_json, {})
+        lookup = format_metadata.fetch(:letter_case, nil)&.call
+        field_val = value.send(field.name)
+
+        if raw_data.is_a?(::Hash) && lookup && raw_data.key?(lookup)
+          if field_val.class.include?(::Crystalline::MetadataFields) && raw_data[lookup].is_a?(::Hash)
+            nested_matched, nested_inexact, nested_unmatched = count_matched_fields(field_val, raw_data[lookup])
+            matched += nested_matched
+            inexact += nested_inexact
+            unmatched += nested_unmatched
+          else
+            matched += 1
+            if field_val.respond_to?(:known?) && !field_val.known?
+              inexact += 1
+            end
+          end
+        elsif !::Crystalline::Utils.nilable?(field.type)
+          unmatched += 1
+        end
+      end
+    elsif value.is_a?(::Array)
+      matched = value.length
+    elsif value.is_a?(::Hash)
+      matched = value.length
+    else
+      matched = 1
+    end
+
+    [matched, inexact, unmatched]
+  end
+
   def self.non_nilable_attr_count(klass)
     # somewhat sane sort ordering for Union deserialization.
     # All Crystalline objects return the number of non-nilable fields

data/lib/crystalline/types.rb

@@ -14,7 +14,7 @@ module Crystalline
 
   class Hash
     attr_accessor :key_type, :value_type
-    
+
     def initialize(key_type, value_type)
       @key_type = key_type
       @value_type = value_type
@@ -23,7 +23,7 @@ module Crystalline
 
   class Union
     attr_accessor :types
-    
+
     def initialize(*types)
       @types = types
     end
@@ -31,7 +31,7 @@ module Crystalline
 
   class Nilable
     attr_accessor :inner_type
-    
+
     def initialize(inner_type)
       @inner_type = inner_type
     end
@@ -40,6 +40,58 @@ module Crystalline
   class Boolean
   end
 
+  # Wraps an unrecognized payload from an open discriminated union.
+  # Produced when the discriminator value is missing, unknown, or schema validation fails.
+  class Unknown
+    attr_reader :raw
+
+    def initialize(raw:)
+      @raw = raw
+    end
+
+    def unknown?
+      true
+    end
+  end
+
+  # Forward-compatible discriminated union parser.
+  # Known discriminator values are deserialized to their mapped types.
+  # Unknown or invalid payloads are captured as Crystalline::Unknown.
+  class DiscriminatedUnion
+    attr_reader :discriminator, :variants
+
+    def initialize(discriminator, variants)
+      @discriminator = discriminator
+      @variants = variants
+    end
+
+    def parse(payload)
+      unless payload.is_a?(::Hash)
+        return Unknown.new(raw: payload)
+      end
+
+      disc_value = payload[@discriminator]
+      unless disc_value.is_a?(::String)
+        return Unknown.new(raw: payload)
+      end
+
+      variant_type = @variants[disc_value]
+      unless variant_type
+        return Unknown.new(raw: payload)
+      end
+
+      begin
+        Crystalline.unmarshal_json(payload, variant_type)
+      rescue StandardError
+        Unknown.new(raw: payload)
+      end
+    end
+  end
+
+  def self.unknown?(value)
+    value.is_a?(Unknown)
+  end
+
   module Enum
     def self.included(base)
       base.extend(ClassMethods)
@@ -67,9 +119,19 @@ module Crystalline
         end
       end
 
+      def open!
+        @open = true
+      end
+
+      def open?
+        @open == true
+      end
+
       def deserialize(val)
         if @mapping.include? val
           @mapping[val]
+        elsif open?
+          new(val)
         else
           raise "Invalid value for enum: #{val}"
         end
@@ -79,5 +141,30 @@ module Crystalline
     def serialize
       @val
     end
+
+    def to_s
+      serialize.to_s
+    end
+
+    def inspect
+      "#<#{self.class} #{serialize.inspect}>"
+    end
+
+    def known?
+      self.class.instance_variable_get(:@mapping)&.value?(self) || false
+    end
+
+    def ==(other)
+      other = other.serialize if other.is_a?(self.class)
+      @val == other
+    end
+
+    def eql?(other)
+      self == other
+    end
+
+    def hash
+      @val.hash
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: authlete_ruby_sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.2.beta
+  version: 0.0.5.pre.beta
 platform: ruby
 authors:
 - Authlete, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-20 00:00:00.000000000 Z
+date: 2026-03-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -36,14 +36,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.14.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.14.1
 - !ruby/object:Gem::Dependency
   name: faraday-multipart
   requirement: !ruby/object:Gem::Requirement
@@ -128,6 +128,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.4.1
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.1
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -232,6 +246,7 @@ files:
 - lib/authlete/introspection.rb
 - lib/authlete/jose_object.rb
 - lib/authlete/jwk_set_endpoint.rb
+- lib/authlete/lifecycle.rb
 - lib/authlete/models/callbacks.rb
 - lib/authlete/models/components.rb
 - lib/authlete/models/components/access_token.rb
@@ -316,12 +331,16 @@ files:
 - lib/authlete/models/components/client_auth_method.rbi
 - lib/authlete/models/components/client_authorization_delete_response.rb
 - lib/authlete/models/components/client_authorization_delete_response.rbi
+- lib/authlete/models/components/client_authorization_get_list_request.rb
+- lib/authlete/models/components/client_authorization_get_list_request.rbi
 - lib/authlete/models/components/client_authorization_get_list_response.rb
 - lib/authlete/models/components/client_authorization_get_list_response.rbi
 - lib/authlete/models/components/client_authorization_update_request.rb
 - lib/authlete/models/components/client_authorization_update_request.rbi
 - lib/authlete/models/components/client_authorization_update_response.rb
 - lib/authlete/models/components/client_authorization_update_response.rbi
+- lib/authlete/models/components/client_clientsource.rb
+- lib/authlete/models/components/client_clientsource.rbi
 - lib/authlete/models/components/client_extension.rb
 - lib/authlete/models/components/client_extension.rbi
 - lib/authlete/models/components/client_extension_requestable_scopes_get_response.rb
@@ -344,6 +363,8 @@ files:
 - lib/authlete/models/components/client_limited.rbi
 - lib/authlete/models/components/client_limited_authorization.rb
 - lib/authlete/models/components/client_limited_authorization.rbi
+- lib/authlete/models/components/client_limited_authorization_clientsource.rb
+- lib/authlete/models/components/client_limited_authorization_clientsource.rbi
 - lib/authlete/models/components/client_registration_response.rb
 - lib/authlete/models/components/client_registration_response.rbi
 - lib/authlete/models/components/client_registration_response_action.rb
@@ -358,8 +379,6 @@ files:
 - lib/authlete/models/components/client_secret_update_response.rbi
 - lib/authlete/models/components/client_type.rb
 - lib/authlete/models/components/client_type.rbi
-- lib/authlete/models/components/clientsource.rb
-- lib/authlete/models/components/clientsource.rbi
 - lib/authlete/models/components/credential_issuance_order.rb
 - lib/authlete/models/components/credential_issuance_order.rbi
 - lib/authlete/models/components/credential_issuer_metadata.rb
@@ -744,14 +763,32 @@ files:
 - lib/authlete/models/operations/backchannel_authentication_issue_api_request.rbi
 - lib/authlete/models/operations/backchannel_authentication_issue_api_response.rb
 - lib/authlete/models/operations/backchannel_authentication_issue_api_response.rbi
+- lib/authlete/models/operations/client_authorization_delete_api_post_request.rb
+- lib/authlete/models/operations/client_authorization_delete_api_post_request.rbi
+- lib/authlete/models/operations/client_authorization_delete_api_post_requestbody.rb
+- lib/authlete/models/operations/client_authorization_delete_api_post_requestbody.rbi
+- lib/authlete/models/operations/client_authorization_delete_api_post_response.rb
+- lib/authlete/models/operations/client_authorization_delete_api_post_response.rbi
 - lib/authlete/models/operations/client_authorization_delete_api_request.rb
 - lib/authlete/models/operations/client_authorization_delete_api_request.rbi
 - lib/authlete/models/operations/client_authorization_delete_api_response.rb
 - lib/authlete/models/operations/client_authorization_delete_api_response.rbi
+- lib/authlete/models/operations/client_authorization_delete_by_subject_api_request.rb
+- lib/authlete/models/operations/client_authorization_delete_by_subject_api_request.rbi
+- lib/authlete/models/operations/client_authorization_delete_by_subject_api_response.rb
+- lib/authlete/models/operations/client_authorization_delete_by_subject_api_response.rbi
+- lib/authlete/models/operations/client_authorization_get_list_api_post_request.rb
+- lib/authlete/models/operations/client_authorization_get_list_api_post_request.rbi
+- lib/authlete/models/operations/client_authorization_get_list_api_post_response.rb
+- lib/authlete/models/operations/client_authorization_get_list_api_post_response.rbi
 - lib/authlete/models/operations/client_authorization_get_list_api_request.rb
 - lib/authlete/models/operations/client_authorization_get_list_api_request.rbi
 - lib/authlete/models/operations/client_authorization_get_list_api_response.rb
 - lib/authlete/models/operations/client_authorization_get_list_api_response.rbi
+- lib/authlete/models/operations/client_authorization_get_list_by_subject_api_request.rb
+- lib/authlete/models/operations/client_authorization_get_list_by_subject_api_request.rbi
+- lib/authlete/models/operations/client_authorization_get_list_by_subject_api_response.rb
+- lib/authlete/models/operations/client_authorization_get_list_by_subject_api_response.rbi
 - lib/authlete/models/operations/client_authorization_update_api_request.rb
 - lib/authlete/models/operations/client_authorization_update_api_request.rbi
 - lib/authlete/models/operations/client_authorization_update_api_response.rb
@@ -772,6 +809,10 @@ files:
 - lib/authlete/models/operations/client_extension_requestables_scopes_get_api_request.rbi
 - lib/authlete/models/operations/client_extension_requestables_scopes_get_api_response.rb
 - lib/authlete/models/operations/client_extension_requestables_scopes_get_api_response.rbi
+- lib/authlete/models/operations/client_extension_requestables_scopes_update_api_post_request.rb
+- lib/authlete/models/operations/client_extension_requestables_scopes_update_api_post_request.rbi
+- lib/authlete/models/operations/client_extension_requestables_scopes_update_api_post_response.rb
+- lib/authlete/models/operations/client_extension_requestables_scopes_update_api_post_response.rbi
 - lib/authlete/models/operations/client_extension_requestables_scopes_update_api_request.rb
 - lib/authlete/models/operations/client_extension_requestables_scopes_update_api_request.rbi
 - lib/authlete/models/operations/client_extension_requestables_scopes_update_api_response.rb
@@ -792,10 +833,24 @@ files:
 - lib/authlete/models/operations/client_granted_scopes_delete_api_request.rbi
 - lib/authlete/models/operations/client_granted_scopes_delete_api_response.rb
 - lib/authlete/models/operations/client_granted_scopes_delete_api_response.rbi
+- lib/authlete/models/operations/client_granted_scopes_delete_by_subject_api_request.rb
+- lib/authlete/models/operations/client_granted_scopes_delete_by_subject_api_request.rbi
+- lib/authlete/models/operations/client_granted_scopes_delete_by_subject_api_response.rb
+- lib/authlete/models/operations/client_granted_scopes_delete_by_subject_api_response.rbi
+- lib/authlete/models/operations/client_granted_scopes_get_api_post_request.rb
+- lib/authlete/models/operations/client_granted_scopes_get_api_post_request.rbi
+- lib/authlete/models/operations/client_granted_scopes_get_api_post_requestbody.rb
+- lib/authlete/models/operations/client_granted_scopes_get_api_post_requestbody.rbi
+- lib/authlete/models/operations/client_granted_scopes_get_api_post_response.rb
+- lib/authlete/models/operations/client_granted_scopes_get_api_post_response.rbi
 - lib/authlete/models/operations/client_granted_scopes_get_api_request.rb
 - lib/authlete/models/operations/client_granted_scopes_get_api_request.rbi
 - lib/authlete/models/operations/client_granted_scopes_get_api_response.rb
 - lib/authlete/models/operations/client_granted_scopes_get_api_response.rbi
+- lib/authlete/models/operations/client_granted_scopes_get_by_subject_api_request.rb
+- lib/authlete/models/operations/client_granted_scopes_get_by_subject_api_request.rbi
+- lib/authlete/models/operations/client_granted_scopes_get_by_subject_api_response.rb
+- lib/authlete/models/operations/client_granted_scopes_get_by_subject_api_response.rbi
 - lib/authlete/models/operations/client_registration_api_request.rb
 - lib/authlete/models/operations/client_registration_api_request.rbi
 - lib/authlete/models/operations/client_registration_api_requestbody.rb
@@ -858,6 +913,10 @@ files:
 - lib/authlete/models/operations/federation_registration_api_request.rbi
 - lib/authlete/models/operations/federation_registration_api_response.rb
 - lib/authlete/models/operations/federation_registration_api_response.rbi
+- lib/authlete/models/operations/get_api_lifecycle_healthcheck_request.rb
+- lib/authlete/models/operations/get_api_lifecycle_healthcheck_request.rbi
+- lib/authlete/models/operations/get_api_lifecycle_healthcheck_response.rb
+- lib/authlete/models/operations/get_api_lifecycle_healthcheck_response.rbi
 - lib/authlete/models/operations/grant_m_api_request.rb
 - lib/authlete/models/operations/grant_m_api_request.rbi
 - lib/authlete/models/operations/grant_m_api_response.rb
@@ -994,6 +1053,7 @@ files:
 - lib/authlete/verifiable_credentials.rb
 - lib/authlete_ruby_sdk.rb
 - lib/crystalline.rb
+- lib/crystalline/enum.rbi
 - lib/crystalline/metadata_fields.rb
 - lib/crystalline/module.rb
 - lib/crystalline/types.rb

data/lib/authlete/models/components/clientsource.rbi

@@ -1,11 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-
-class Authlete::Models::Components::ClientSource
-  extend ::Crystalline::MetadataFields::ClassMethods
-end
-
-
-class Authlete::Models::Components::ClientSource
-end