purple-client 0.1.7.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f57285cc0997c1352f58c090079dc236e52ecf08c040b1a2d68b2e44824b344
-  data.tar.gz: '094e99048e10af59faabec36d819ec1b075a65bfb47eaebd422ddee9dd216d84'
+  metadata.gz: 904a3aae97dec86b01cba57ebe806b9745cbce75803e986e63ae953209642455
+  data.tar.gz: 92397c8c6a2862fd4366d58dd67bc255933252d91becad2af58241ed1a0e3234
 SHA512:
-  metadata.gz: e2a8c339a3dfa90dc44444b421b13c819152e3f0c9ce3a0bede32604c9b5bf00ea9068bfff074bc84c8165093167f2c1bb8756ba0fbb059a0e8cb03ebc63705c
-  data.tar.gz: 8ae3c368e5130486f5c4d466d9232095da167f957134ef2192798fc446b79f69ceb635c8bd1a14f91b745a8f0cdf6bab7384d9e71b46e9bdd17c30868da8bd5a
+  metadata.gz: 7072c78039ce88e59465cd91950eca347c11e876639490235f354ff5e8fad4cef31a84128c4b90ab28b6efd107bea3b91620f27f03c1ad19f06744803268510f
+  data.tar.gz: 6fa661c3de144a83de31fc3cdcdbd199ea6fd3d38643d2b60bbb4e243893074adaa19b6bc5daf7118b1a5339bb754d9fc3d1c809e09af7006281cb465177b7ae

data/lib/purple/path.rb

@@ -4,6 +4,7 @@ require 'dry-initializer'
 require 'faraday'
 require 'active_support/core_ext/hash/deep_merge'
 require 'active_support/core_ext/object/inclusion'
+require 'active_support/core_ext/object/blank'
 
 module Purple
   class Path
@@ -66,6 +67,10 @@ module Purple
         conn.headers = headers
       end
 
+      if client.domain.blank?
+        raise ArgumentError, 'Client domain is not set. Please set the domain in the client configuration.'
+      end
+
       unless client.domain.start_with?('http')
         raise ArgumentError, "Invalid URL: #{client.domain}. Ensure you have set protocol (http/https) in the client domain."
       end

data/lib/purple/responses/body.rb

@@ -20,29 +20,29 @@ class Purple::Responses::Body
   def validate!(body, arguments)
     parsed_body = JSON.parse(body, symbolize_names: true)
 
-    result = if parsed_body.is_a? Integer
-               parsed_body
-             else
-               underscored_body = if parsed_body.is_a? Array
-                                    parsed_body.map { |item| item.transform_keys { |key| key.to_s.underscore.to_sym } }
-                                  else
-                                    parsed_body.transform_keys { |key| key.to_s.underscore.to_sym }
-                                  end
-
-               if underscored_body.is_a? Array
-                 underscored_body.each do |item|
-                   check_structure!(item)
-                 end
-               else
-                 check_structure!(underscored_body)
-               end
-
-               if underscored_body.is_a?(Array)
-                 underscored_body.map { |item| create_object(item) }
-               else
-                 create_object(underscored_body)
-               end
-             end
+    if parsed_body.is_a? Integer
+      parsed_body
+    else
+      underscored_body = if parsed_body.is_a? Array
+                           parsed_body.map { |item| item.transform_keys { |key| key.to_s.underscore.to_sym } }
+                         else
+                           parsed_body.transform_keys { |key| key.to_s.underscore.to_sym }
+                         end
+
+      if underscored_body.is_a? Array
+        underscored_body.each do |item|
+          check_structure!(item)
+        end
+      else
+        check_structure!(underscored_body)
+      end
+
+      if underscored_body.is_a?(Array)
+        underscored_body.map { |item| create_klass(item, structure) }
+      else
+        create_klass(underscored_body, structure)
+      end
+    end => result
 
     if transform.is_a?(Proc)
       transform.call(result, arguments)
@@ -55,16 +55,24 @@ class Purple::Responses::Body
 
   private
 
-  def create_object(body)
-    object = Class.new(Purple::Responses::Object) do
+  def create_klass(body, structure)
+    klass = Class.new(Purple::Responses::Object) do
       body.each do |key, value|
         define_method(key) { value }
       end
+
+      structure.each do |key, value|
+        if value.is_a?(Hash) && value[:optional] == true && !body.key?(key)
+          define_method(key) do
+            raise NoMethodError, "Optional field '#{key}' is not present in the response body. Use `contain?(:#{key})` to check its presence."
+          end
+        end
+      end
     end.new
 
-    object.attributes = body
+    klass.attributes = body
 
-    object
+    klass
   end
 
   def check_structure!(object, substructure = structure)
@@ -81,12 +89,26 @@ class Purple::Responses::Body
           check_structure!(object[key], substructure[key])
         end
       elsif value.is_a?(Array)
-        object[key].each do |item|
-          if value[0].is_a?(Symbol)
-            raise "Body structure definition error in key '#{key}' of structure #{substructure}."
-          end
+        if object[key].nil?
+          raise BodyStructureMismatchError.new(key, value, nil, object),
+            "Expected a non-nil array for '#{key}' in response body.\n\nExpected response structure: #{substructure}.\n\nUse '#{key}: { type: #{value}, allow_blank: true }' if this field can be nil."
+        end
 
-          check_structure!(item, value[0])
+        type = value.first
+
+        if type.is_a?(Symbol)
+          raise "Body structure definition error in key '#{key}' of structure #{substructure}."
+        end
+
+        object[key].each_with_index do |item, index|
+          if type.is_a?(Class)
+            unless item.is_a?(type)
+              raise BodyStructureMismatchError.new(key, type, item, object),
+                "Expected item at #{index} index of '#{key}' to be of type '#{value[index]}', but got '#{item.class}' with value '#{item}'."
+            end
+          else
+            check_structure!(item, type)
+          end
         end
       else
         if object.nil?
@@ -104,7 +126,7 @@ class Purple::Responses::Body
 
     unless object.key?(key)
       raise BodyStructureMismatchError.new(key, expected_type, object[key], object),
-        "Missing field '#{key}' in response body. Body: #{object}"
+        "Missing field '#{key}' in response body. Body: #{object}\n\nUse '#{key}: { type: #{expected_type}, optional: true }' if this field may be absent."
     end
 
     return if expected_type == Purple::Boolean && (object[key] == true || object[key] == false)

data/lib/purple/responses/object.rb

@@ -6,4 +6,8 @@ class Purple::Responses::Object
   attr_accessor :attributes
 
   delegate :to_s, to: :attributes
+
+  def contain?(key)
+    attributes.key?(key)
+  end
 end

data/lib/purple/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Purple
-  VERSION = "0.1.7.6"
+  VERSION = "0.1.8"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: purple-client
 version: !ruby/object:Gem::Version
-  version: 0.1.7.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Pavel Kalashnikov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-01 00:00:00.000000000 Z
+date: 2025-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-initializer