interactor_support 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 315dd265352ed997c5b69934609478e6e5f8b61bbe74bba065acf495f7dac41c
-  data.tar.gz: 6a942d0ccb3f3323d156d85f302987b4af7809cdcce852dca56fb9b1ae8419bc
+  metadata.gz: bf8cda13999c9971a1499398e23135ef6e870af7581ffe7e9f173b9d7c4231ea
+  data.tar.gz: 48c401b5b42e80ccea3db170ecb1e8476861522804b800ad28651eebfa674222
 SHA512:
-  metadata.gz: 2fb25732876e4702b12da283cf4d205504c597ecb904cc9406af3a9825814e8ba518e84bcc615c1c8aadc31ed81cfb9008e2addf759273c2688e029d5b07628e
-  data.tar.gz: 5615bf986b8ab272cff775eebbd874c336be93f4e17333d37fd6e87a04b9d74d110b2fcab2a48fb1e0ff86956785b4a7825d03f4201701700566825c2335c633
+  metadata.gz: 2adf5f317e6432571a24358e9e1ba453397fcfd5f6b83758930fd45bef652dfb01ead87aa68fcfec385151bd60646127a087968e332baa0193e5bb9f7ac14ff6
+  data.tar.gz: a6a670cacb4abd50812a82232dcbeb1e582eea72d3526b2659f4dccd827226c6e07c6b12f6c39b282eb276db482d02911cd4d0e125094f8c1d114fba5459c899

data/CHANGELOG.md

@@ -29,3 +29,9 @@
 - Introduce `InteractorSupport.configuration.logger` and `log_level` for customizable logging
 - Override `assign_attributes` to integrate attribute ignoring and error-raising behavior
 - Improve test coverage for unknown attribute handling and logging
+
+## [1.0.6] - 2025-09-24
+
+- Wrap request object validation failures from `Organizable#organize` in `InteractorSupport::Errors::InvalidRequestObject` for consistent controller handling
+- Honor `configuration.log_unknown_request_object_attributes` when logging ignored request object keys
+- Improve request object error messaging for failed casts and unknown attributes

data/README.md

@@ -559,7 +559,7 @@ The Organizable concern provides utility methods to simplify working with intera
 
 Features
 
-- organize: Call interactors with request objects, optionally namespaced under a context_key.
+- organize: Call interactors with request objects, optionally namespaced under a context_key, and wrap validation failures in a consistent error.
 - request_params: Extract, shape, filter, rename, flatten, and merge incoming params in a clear and declarative way.
 - Built for controllers or service entry points.
 - Rails-native feel — works seamlessly with strong params.
@@ -588,6 +588,18 @@ organize(MyInteractor, params: request_params, request_object: MyRequest, contex
 # => MyInteractor.call({ request: MyRequest.new(params) })
 ```
 
+Validation failures inside the request object raise `InteractorSupport::Errors::InvalidRequestObject`. The exception exposes the request class and its validation messages, making it straightforward to surface errors back to the caller.
+
+```rb
+def create
+  organize(CreateUserInteractor, params: request_params(:user), request_object: CreateUserRequest)
+  redirect_to dashboard_path
+rescue InteractorSupport::Errors::InvalidRequestObject => e
+  flash.now[:alert] = "Unable to continue: #{e.errors.to_sentence}"
+  render :new, status: :unprocessable_entity
+end
+```
+
 #### #request_params(\*top_level_keys, merge: {}, except: [], rewrite: [])
 
 Returns a shaped parameter hash derived from params.permit!. You can extract specific top-level keys, rename them, flatten values, apply defaults, and remove unwanted fields.

data/lib/interactor_support/concerns/organizable.rb

@@ -38,8 +38,22 @@ module InteractorSupport
       #   # => Calls MyInteractor with an instance of MyRequest initialized with request_params at :context_key.
       #   #   # => The context will contain { request: MyRequest.new(request_params) }
       def organize(interactor, params:, request_object:, context_key: nil)
+        request_payload = request_object.new(params)
+
         @context = interactor.call(
-          context_key ? { context_key => request_object.new(params) } : request_object.new(params),
+          context_key ? { context_key => request_payload } : request_payload,
+        )
+      rescue ActiveModel::ValidationError => e
+        errors =
+          if e.model&.respond_to?(:errors)
+            e.model.errors.full_messages
+          else
+            []
+          end
+
+        raise InteractorSupport::Errors::InvalidRequestObject.new(
+          request_class: request_object,
+          errors: errors,
         )
       end
 

data/lib/interactor_support/errors.rb

@@ -1,8 +1,55 @@
 module InteractorSupport
   module Errors
     class UnknownAttribute < StandardError
-      def initialize(attribute)
-        super("Unknown attribute: #{attribute}")
+      attr_reader :attribute, :owner
+
+      def initialize(attribute, owner: nil)
+        @attribute = attribute
+        @owner = owner
+        super(build_message(attribute, owner))
+      end
+
+      private
+
+      def build_message(attribute, owner)
+        name =
+          case attribute
+          when String then attribute
+          when Symbol then attribute.to_s
+          else attribute.inspect
+          end
+
+        owner_name =
+          if owner.respond_to?(:name) && owner.name
+            owner.name
+          elsif owner.respond_to?(:to_s)
+            owner.to_s
+          else
+            owner
+          end
+
+        suffix = owner_name ? " for #{owner_name}" : ''
+        "Unknown attribute: #{name}#{suffix}"
+      end
+    end
+
+    class InvalidRequestObject < StandardError
+      attr_reader :request_class, :errors
+
+      def initialize(request_class:, errors: [])
+        @request_class = request_class
+        @errors = Array(errors)
+
+        request_name =
+          if request_class.respond_to?(:name) && request_class.name
+            request_class.name
+          else
+            request_class.to_s
+          end
+
+        detail = @errors.any? ? ": #{@errors.join(', ')}" : ''
+
+        super("Invalid #{request_name}#{detail}")
       end
     end
   end

data/lib/interactor_support/request_object.rb

@@ -105,12 +105,14 @@ module InteractorSupport
           if respond_to?(setter)
             send(setter, v)
           elsif respond_to?(:ignore_unknown_attributes?) && ignore_unknown_attributes?
-            InteractorSupport.configuration.logger.log(
-              InteractorSupport.configuration.log_level,
-              "InteractorSupport::RequestObject ignoring unknown attribute '#{k}' for #{self.class.name}.",
-            )
+            if InteractorSupport.configuration.log_unknown_request_object_attributes
+              InteractorSupport.configuration.logger.log(
+                InteractorSupport.configuration.log_level,
+                "InteractorSupport::RequestObject ignoring unknown attribute '#{k}' for #{self.class.name}.",
+              )
+            end
           else
-            raise Errors::UnknownAttribute, "`#{k}` for #{self.class.name}."
+            raise Errors::UnknownAttribute.new(k, owner: self.class)
           end
         end
       end
@@ -232,7 +234,13 @@ module InteractorSupport
         message = ":#{type} is not a supported type. Supported types are: #{SUPPORTED_TYPES.join(", ")}"
         raise TypeError, message
       rescue
-        raise TypeError, "Cannot cast #{value.inspect} to #{type.name}"
+        type_name =
+          if type.respond_to?(:name) && type.name
+            type.name
+          else
+            type.to_s
+          end
+        raise TypeError, "Cannot cast #{value.inspect} to #{type_name}"
       end
     end
   end

data/lib/interactor_support/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InteractorSupport
-  VERSION = '1.0.5'
+  VERSION = '1.0.6'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: interactor_support
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - Charlie Mitchell
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-01 00:00:00.000000000 Z
+date: 2025-09-24 00:00:00.000000000 Z
 dependencies: []
 description:
 email: