treaty 0.19.0 → 0.20.0

data/lib/treaty/request/attribute/builder.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Request
-    module Attribute
-      # Request-specific attribute builder
-      class Builder < Treaty::Entity::Attribute::Builder::Base
-        private
-
-        def create_attribute(name, type, *helpers, nesting_level:, **options, &block)
-          Attribute.new(
-            name,
-            type,
-            *helpers,
-            nesting_level:,
-            **options,
-            &block
-          )
-        end
-
-        # Deep copies an attribute with adjusted nesting level for Request context.
-        #
-        # @param source_attribute [Treaty::Entity::Attribute::Base] Attribute to copy
-        # @param new_nesting_level [Integer] New nesting level
-        # @return [Request::Attribute::Attribute] Copied attribute
-        def deep_copy_attribute(source_attribute, new_nesting_level) # rubocop:disable Metrics/MethodLength
-          copied = Attribute.new(
-            source_attribute.name,
-            source_attribute.type,
-            nesting_level: new_nesting_level,
-            **deep_copy_options(source_attribute.options)
-          )
-
-          return copied unless source_attribute.nested?
-
-          source_attribute.collection_of_attributes.each do |nested_source|
-            nested_copied = deep_copy_attribute(nested_source, new_nesting_level + 1)
-            copied.collection_of_attributes << nested_copied
-          end
-
-          copied
-        end
-      end
-    end
-  end
-end

data/lib/treaty/request/entity.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Request
-    # Entity class for request definitions.
-    # Attributes are required by default.
-    #
-    # This class is used internally when defining request blocks.
-    # When you write a request block, Treaty creates an anonymous
-    # class based on Request::Entity.
-    class Entity
-      include Treaty::Entity::Attribute::DSL
-
-      class << self
-        private
-
-        # Creates a Request::Attribute::Attribute for this Request::Entity class
-        #
-        # @return [Request::Attribute::Attribute] Created attribute instance
-        def create_attribute(name, type, *helpers, nesting_level:, **options, &block)
-          Attribute::Attribute.new(
-            name,
-            type,
-            *helpers,
-            nesting_level:,
-            **options,
-            &block
-          )
-        end
-      end
-    end
-  end
-end

data/lib/treaty/request/factory.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Request
-    # Factory for creating request definitions.
-    #
-    # Supports two modes:
-    # 1. Block mode: Creates an anonymous Request::Entity class with the block
-    # 2. Entity mode: Uses a provided Entity class directly
-    #
-    # ## Block Mode
-    #
-    # ```ruby
-    # request do
-    #   object :post do
-    #     string :title
-    #   end
-    # end
-    # ```
-    #
-    # ## Entity Mode
-    #
-    # ```ruby
-    # request Posts::Create::RequestEntity
-    # ```
-    class Factory
-      # Uses a provided Entity class
-      #
-      # @param entity_class [Class] Entity class to use
-      # @return [void]
-      # @raise [Treaty::Exceptions::Validation] if entity_class is not a valid Treaty::Entity::Base subclass
-      def use_entity(entity_class)
-        validate_entity_class!(entity_class)
-        @entity_class = entity_class
-      end
-
-      # Returns collection of attributes from the entity class
-      #
-      # @return [Collection] Collection of attributes
-      def collection_of_attributes
-        return Treaty::Entity::Attribute::Collection.new if @entity_class.nil?
-
-        @entity_class.collection_of_attributes
-      end
-
-      # Handles DSL methods for defining attributes
-      #
-      # This allows the factory to be used with method_missing
-      # for backwards compatibility with direct method calls.
-      # Creates an anonymous Request::Entity class on first use.
-      def method_missing(type, *helpers, **options, &block)
-        # If no entity class yet, create one
-        @entity_class ||= Class.new(Entity)
-
-        # Call the method on the entity class
-        @entity_class.public_send(type, *helpers, **options, &block)
-      end
-
-      def respond_to_missing?(name, *)
-        super
-      end
-
-      private
-
-      # Validates that the provided entity_class is a valid Treaty::Entity::Base subclass
-      #
-      # @param entity_class [Class] Entity class to validate
-      # @raise [Treaty::Exceptions::Validation] if entity_class is not a valid Treaty::Entity::Base subclass
-      def validate_entity_class!(entity_class)
-        return if entity_class.is_a?(Class) && entity_class < Treaty::Entity::Base
-
-        raise Treaty::Exceptions::Validation,
-              I18n.t(
-                "treaty.request.factory.invalid_entity_class",
-                type: entity_class.class,
-                value: entity_class
-              )
-      end
-    end
-  end
-end

data/lib/treaty/request/validator.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Request
-    # Validator for request data
-    class Validator
-      class << self
-        # Validates request parameters against the request definition
-        #
-        # @param params [Hash] Request parameters to validate
-        # @param version_factory [Versions::Factory] Version factory with request definition
-        # @return [Hash] Validated and transformed parameters
-        def validate!(params:, version_factory:)
-          new(params:, version_factory:).validate!
-        end
-      end
-
-      def initialize(params:, version_factory:)
-        @params = params
-        @version_factory = version_factory
-      end
-
-      def validate!
-        validate_request_attributes!
-      end
-
-      private
-
-      def request_data
-        @request_data ||= begin
-          @params.to_unsafe_h
-        rescue NoMethodError
-          @params
-        end
-      end
-
-      def validate_request_attributes!
-        return request_data unless request_attributes_exist?
-
-        # Validate request attributes with orchestrator:
-        orchestrator_class = Class.new(Treaty::Entity::Attribute::Validation::Orchestrator::Base) do
-          define_method(:collection_of_attributes) do
-            @version_factory.request_factory.collection_of_attributes
-          end
-        end
-
-        orchestrator_class.validate!(
-          version_factory: @version_factory,
-          data: request_data
-        )
-      end
-
-      def request_attributes_exist?
-        return false if @version_factory.request_factory&.collection_of_attributes&.empty?
-
-        @version_factory.request_factory.collection_of_attributes.exists?
-      end
-    end
-  end
-end

data/lib/treaty/response/attribute/attribute.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Response
-    module Attribute
-      # Response-specific attribute that defaults to required: false
-      class Attribute < Treaty::Entity::Attribute::Base
-        private
-
-        def apply_defaults!
-          # For response: optional by default (false).
-          # message: nil means use I18n default message from validators
-          @options[:required] ||= { is: false, message: nil }
-        end
-
-        def process_nested_attributes(&block)
-          return unless object_or_array?
-
-          builder = Builder.new(collection_of_attributes, @nesting_level + 1)
-          builder.instance_eval(&block)
-        end
-      end
-    end
-  end
-end

data/lib/treaty/response/attribute/builder.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Response
-    module Attribute
-      # Response-specific attribute builder
-      class Builder < Treaty::Entity::Attribute::Builder::Base
-        private
-
-        def create_attribute(name, type, *helpers, nesting_level:, **options, &block)
-          Attribute.new(
-            name,
-            type,
-            *helpers,
-            nesting_level:,
-            **options,
-            &block
-          )
-        end
-
-        # Deep copies an attribute with adjusted nesting level for Response context.
-        #
-        # @param source_attribute [Treaty::Entity::Attribute::Base] Attribute to copy
-        # @param new_nesting_level [Integer] New nesting level
-        # @return [Response::Attribute::Attribute] Copied attribute
-        def deep_copy_attribute(source_attribute, new_nesting_level) # rubocop:disable Metrics/MethodLength
-          copied = Attribute.new(
-            source_attribute.name,
-            source_attribute.type,
-            nesting_level: new_nesting_level,
-            **deep_copy_options(source_attribute.options)
-          )
-
-          return copied unless source_attribute.nested?
-
-          source_attribute.collection_of_attributes.each do |nested_source|
-            nested_copied = deep_copy_attribute(nested_source, new_nesting_level + 1)
-            copied.collection_of_attributes << nested_copied
-          end
-
-          copied
-        end
-      end
-    end
-  end
-end

data/lib/treaty/response/entity.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Response
-    # Entity class for response definitions.
-    # Attributes are optional by default.
-    #
-    # This class is used internally when defining response blocks.
-    # When you write a response block, Treaty creates an anonymous
-    # class based on Response::Entity.
-    class Entity
-      include Treaty::Entity::Attribute::DSL
-
-      class << self
-        private
-
-        # Creates a Response::Attribute::Attribute for this Response::Entity class
-        #
-        # @return [Response::Attribute::Attribute] Created attribute instance
-        def create_attribute(name, type, *helpers, nesting_level:, **options, &block)
-          Attribute::Attribute.new(
-            name,
-            type,
-            *helpers,
-            nesting_level:,
-            **options,
-            &block
-          )
-        end
-      end
-    end
-  end
-end

data/lib/treaty/response/factory.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Response
-    # Factory for creating response definitions.
-    #
-    # Supports two modes:
-    # 1. Block mode: Creates an anonymous Response::Entity class with the block
-    # 2. Entity mode: Uses a provided Entity class directly
-    #
-    # ## Block Mode
-    #
-    # ```ruby
-    # response 200 do
-    #   object :post do
-    #     string :id
-    #   end
-    # end
-    # ```
-    #
-    # ## Entity Mode
-    #
-    # ```ruby
-    # response 200, Posts::Create::ResponseEntity
-    # ```
-    class Factory
-      attr_reader :status
-
-      def initialize(status)
-        @status = status
-      end
-
-      # Uses a provided Entity class
-      #
-      # @param entity_class [Class] Entity class to use
-      # @return [void]
-      # @raise [Treaty::Exceptions::Validation] if entity_class is not a valid Treaty::Entity::Base subclass
-      def use_entity(entity_class)
-        validate_entity_class!(entity_class)
-        @entity_class = entity_class
-      end
-
-      # Returns collection of attributes from the entity class
-      #
-      # @return [Collection] Collection of attributes
-      def collection_of_attributes
-        return Treaty::Entity::Attribute::Collection.new if @entity_class.nil?
-
-        @entity_class.collection_of_attributes
-      end
-
-      # Handles DSL methods for defining attributes
-      #
-      # This allows the factory to be used with method_missing
-      # for backwards compatibility with direct method calls.
-      # Creates an anonymous Response::Entity class on first use.
-      def method_missing(type, *helpers, **options, &block)
-        # If no entity class yet, create one
-        @entity_class ||= Class.new(Entity)
-
-        # Call the method on the entity class
-        @entity_class.public_send(type, *helpers, **options, &block)
-      end
-
-      def respond_to_missing?(name, *)
-        super
-      end
-
-      private
-
-      # Validates that the provided entity_class is a valid Treaty::Entity::Base subclass
-      #
-      # @param entity_class [Class] Entity class to validate
-      # @raise [Treaty::Exceptions::Validation] if entity_class is not a valid Treaty::Entity::Base subclass
-      def validate_entity_class!(entity_class)
-        return if entity_class.is_a?(Class) && entity_class < Treaty::Entity::Base
-
-        raise Treaty::Exceptions::Validation,
-              I18n.t(
-                "treaty.response.factory.invalid_entity_class",
-                type: entity_class.class,
-                value: entity_class
-              )
-      end
-    end
-  end
-end

data/lib/treaty/response/validator.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Response
-    # Validator for response data
-    class Validator
-      class << self
-        # Validates response data against the response definition
-        #
-        # @param response_data [Hash] Response data to validate
-        # @param version_factory [Versions::Factory] Version factory with response definition
-        # @return [Hash] Validated and transformed response data
-        def validate!(version_factory:, response_data: {})
-          new(version_factory:, response_data:).validate!
-        end
-      end
-
-      def initialize(version_factory:, response_data: {})
-        @version_factory = version_factory
-        @response_data = response_data
-      end
-
-      def validate!
-        validate_response_attributes!
-      end
-
-      private
-
-      def validate_response_attributes!
-        return @response_data unless response_attributes_exist?
-
-        # Create orchestrator for response validation
-        # Orchestrator filters data by attributes and performs transformation
-        orchestrator_class = Class.new(Treaty::Entity::Attribute::Validation::Orchestrator::Base) do
-          define_method(:collection_of_attributes) do
-            @version_factory.response_factory.collection_of_attributes
-          end
-        end
-
-        orchestrator_class.validate!(
-          version_factory: @version_factory,
-          data: @response_data
-        )
-      end
-
-      def response_attributes_exist?
-        return false if @version_factory.response_factory&.collection_of_attributes&.empty?
-
-        @version_factory.response_factory.collection_of_attributes.exists?
-      end
-    end
-  end
-end

data/lib/treaty/result.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  class Result
-    attr_reader :data, :status, :version
-
-    def initialize(data:, status:, version:)
-      @data = data
-      @status = status
-      @version = version
-    end
-
-    def inspect
-      "#<#{self.class.name} #{draw_result}>"
-    end
-
-    private
-
-    def draw_result
-      "@data=#{@data.inspect}, @status=#{@status.inspect}, @version=#{@version.inspect}"
-    end
-  end
-end

data/lib/treaty/versions/collection.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Versions
-    class Collection
-      extend Forwardable
-
-      def_delegators :@collection, :<<, :map, :find
-
-      def initialize(collection = Set.new)
-        @collection = collection
-      end
-    end
-  end
-end

data/lib/treaty/versions/dsl.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module Treaty
-  module Versions
-    module DSL
-      def self.included(base)
-        base.extend(ClassMethods)
-        base.include(Workspace)
-      end
-
-      module ClassMethods
-        private
-
-        def version(version, default: false, &block)
-          @version_factory = Factory.new(version:, default:)
-
-          @version_factory.instance_eval(&block)
-          @version_factory.validate_after_block!
-
-          validate_multiple_defaults! if @version_factory.default_result == true
-
-          collection_of_versions << @version_factory
-
-          @version_factory = nil
-        end
-
-        def collection_of_versions
-          @collection_of_versions ||= Collection.new
-        end
-
-        def validate_multiple_defaults!
-          existing_defaults = collection_of_versions.map(&:default_result).count(true)
-
-          return if existing_defaults.zero?
-
-          raise Treaty::Exceptions::VersionMultipleDefaults,
-                I18n.t("treaty.versioning.factory.multiple_defaults")
-        end
-      end
-    end
-  end
-end