convenient_service 0.17.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f24d02cddcb69e9108cf7d810c85f4ccf338201b8a31bbc7da0be1ef92bd91a9
-  data.tar.gz: 89c019fa64f6fe8194c9b74a676d367e390cc5cb33efef361a4fcb448cd72d17
+  metadata.gz: 1943fd64d61a41a18701985f5a7296b7cf3337ab0562c1912ee7765668dd6f3a
+  data.tar.gz: 02e2d46311210cd922b606848f36c82db136a7f2ca2013fba269c6c5eb3adc3a
 SHA512:
-  metadata.gz: a53a4a7fee700e8128eeea830ac57cee73e6a6034d36e61dd224584e06f08ef4d944cdc513bfbac17187866b09969a4f63f31e316745546de032a24965bad6dd
-  data.tar.gz: 47a180d8079468f98eadcfbddc2654323fabeae0d7f8b47febc7c13f80d43d30a30583d7104d60d486b02f6e024155487fe3ce5c20bd1eea39f214ee326dc9ff
+  metadata.gz: 74cded446d90f5b06675c5c19f7647792e195b47178504b14dbf650640186f33679e8bf8c17ad73e214ff5f1b38d233c7919c361f3f90c569435fc14e4c5d999
+  data.tar.gz: a7773a495b1805778221b006427562bd25acd7420c243aab192abaf0460d661d905259aed97a2c489ccd9e77bac349da1516f9dd8ec8d7b573115b5872229b92

data/README.md

@@ -7,7 +7,7 @@
 <!-- stand_with_ukraine:end -->
 
 <!-- header:start -->
-<!-- TODO: Remove html to display in YARD with commonmark -->
+<!-- TODO: Remove html to display in YARD with common mark -->
 <h1 align="center">
   Convenient Service
 </h1>
@@ -23,11 +23,11 @@
 [![Gem Version](https://badge.fury.io/rb/convenient_service.svg)](https://rubygems.org/gems/convenient_service) [![Gem Downloads](https://img.shields.io/gem/dt/convenient_service.svg)](https://rubygems.org/gems/convenient_service) ![visitors](https://visitor-badge.glitch.me/badge?page_id=marian13/convenient_service) ![GitHub repo size](https://img.shields.io/github/repo-size/marian13/convenient_service) [![GitHub Actions CI](https://github.com/marian13/convenient_service/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/marian13/convenient_service/actions/workflows/ci.yml) [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard) [![Coverage Status](https://coveralls.io/repos/github/marian13/convenient_service/badge.svg)](https://coveralls.io/github/marian13/convenient_service?branch=main) [![inline docs](http://inch-ci.org/github/marian13/convenient_service.svg?branch=main)](http://inch-ci.org/github/marian13/convenient_service) [![yard docs](http://img.shields.io/badge/yard-docs-blue.svg)](https://marian13.github.io/convenient_service/)
 [![Convenient Service on stackoverflow](https://img.shields.io/badge/stackoverflow-community-orange.svg?logo=stackoverflow)](https://stackoverflow.com/tags/convenient-service)
 [![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/user?u=31435716&fan_landing=true)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![License: LGPL-3.0](https://img.shields.io/badge/license-LGPL--3.0-yellow.svg)](https://www.gnu.org/licenses/lgpl-3.0.html)
 <!-- badges:end -->
 
 <!-- logo:start -->
-<!-- TODO: Remove html to display in YARD with commonmark -->
+<!-- TODO: Remove html to display in YARD with common mark -->
 <p align="center">
   <img src="https://raw.githubusercontent.com/marian13/convenient_service/main/logo.png" width="300">
 </p>
@@ -40,8 +40,7 @@ Yet another approach to revisit the service object pattern, but this time focusi
 <!-- warning:start -->
 ## ❗❗❗ WARNING ❗❗❗
 
-This library is under heavy development. Public API may be subject to change. The first major release is still to come. Use the current version at your own risk. Ruby 2.7+, JRuby 9.4+ (TruffleRuby support is planned as well). Thanks.
-<!-- features:end -->
+This library is under heavy development. Most of the public API is polished, but it still may be subject to change. It has already been successfully used in production environments for more than a year, but the first major version is planned for the second quarter of 2025. Use the current version at your own risk. Ruby 2.7+, JRuby 9.4+ (TruffleRuby support is planned as well). Thanks.
 <!-- warning:end -->
 
 <!-- links:start -->
@@ -51,7 +50,7 @@ This library is under heavy development. Public API may be subject to change. Th
 
 - Check out [Convenient Service Official User Docs](https://userdocs.convenientservice.org/) for installation, requirements, and usage guides.
 
-- Read [the API docs](https://marian13.github.io/convenient_service) to get familiar with the newest functionality that is not documented yet.
+- Read [the API docs](https://apidocs.convenientservice.org/) to get familiar with the newest functionality that is not documented yet.
 
 - Create [an issue](https://github.com/marian13/convenient_service/issues) if you are going to report a bug.
 
@@ -63,6 +62,8 @@ This library is under heavy development. Public API may be subject to change. Th
 
 - [Static Content](https://github.com/marian13/static_content/tree/main/convenient_service) repo.
 
+- [Convenient Service Integration](https://github.com/marian13/convenient_service_integration) machinery.
+
 - Have a look at [Convenient Service Development Wiki](https://github.com/marian13/convenient_service/wiki) for the contribution tutorials.
 
 <!-- links:end -->
@@ -70,5 +71,5 @@ This library is under heavy development. Public API may be subject to change. Th
 ---
 
 <!-- author:start -->
-Copyright (c) 2022-2023 [Marian Kostyk](http://mariankostyk.com).
+Copyright (c) 2022-2024 Marian Kostyk.
 <!-- author:end -->

data/lib/convenient_service/commands/is_service.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Commands
+    class IsService < Support::Command
+      ##
+      # @!attribute [r] service
+      #   @return [Object] Can be any type.
+      #
+      attr_reader :service
+
+      ##
+      # @param service [Object] Can be any type.
+      # @return [void]
+      #
+      def initialize(service:)
+        @service = service
+      end
+
+      ##
+      # @return [Boolean]
+      #
+      def call
+        Commands::IsServiceClass[service_class: service.class]
+      end
+    end
+  end
+end

data/lib/convenient_service/commands/is_service_class.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Commands
+    class IsServiceClass < Support::Command
+      ##
+      # @!attribute [r] service_class
+      #   @return [Object] Can be any type.
+      #
+      attr_reader :service_class
+
+      ##
+      # @param service_class [Object] Can be any type.
+      # @return [void]
+      #
+      def initialize(service_class:)
+        @service_class = service_class
+      end
+
+      ##
+      # @return [Boolean]
+      #
+      def call
+        return unless service_class.instance_of?(::Class)
+
+        service_class.include?(Service::Configs::Essential)
+      end
+    end
+  end
+end

data/lib/convenient_service/commands.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "commands/is_service_class"
+require_relative "commands/is_service"

data/lib/convenient_service/common/plugins/ensures_negated_j_send_result/middleware.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Common
+    module Plugins
+      module EnsuresNegatedJSendResult
+        class Middleware < MethodChainMiddleware
+          intended_for :negated_result, entity: any_entity
+
+          ##
+          # @return [ConvenientService::Service::Plugins::HasJSendResult::Entities::Result]
+          #
+          def next(...)
+            result = chain.next(...)
+
+            result.negated? ? result : result.copy(overrides: {kwargs: {negated: true}})
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/common/plugins/ensures_negated_j_send_result.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "ensures_negated_j_send_result/middleware"

data/lib/convenient_service/common/plugins/has_around_callbacks/concern.rb

@@ -8,8 +8,15 @@ module ConvenientService
           include Support::Concern
 
           class_methods do
+            ##
+            # @api public
+            #
+            # @param type [Symbol]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
             def around(type, &block)
-              Plugins::HasCallbacks::Entities::Callback.new(types: [:around, type], block: block).tap { |callback| callbacks << callback }
+              callbacks.create(types: [:around, type], block: block)
             end
           end
         end

data/lib/convenient_service/common/plugins/has_around_callbacks/middleware.rb

@@ -5,16 +5,28 @@ module ConvenientService
     module Plugins
       module HasAroundCallbacks
         class Middleware < MethodChainMiddleware
+          include Support::Delegate
+
           ##
           # @internal
-          #   TODO: Move to command.
+          #   TODO: Support of callbacks for class methods.
           #
-          include Support::DependencyContainer::Import
+          intended_for any_method, entity: any_entity
 
-          import :"entities.Callback", from: Common::Plugins::HasCallbacks::Container
-
-          intended_for any_method, scope: any_scope, entity: any_entity
+          ##
+          # @return [Class<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+          #
+          delegate :callback_class, to: :callbacks
 
+          ##
+          # @param args [Array<Object>]
+          # @param kwargs [Hash{Symbol => Object}]
+          # @param block [Proc, nil]
+          # @return [Object] Can be any type.
+          #
+          # @internal
+          #   TODO: Move to command.
+          #
           def next(*args, **kwargs, &block)
             ##
             # A variable that stores return value of middleware `chain.next` aka `original_value`.
@@ -41,12 +53,12 @@ module ConvenientService
             #   end
             # end
             #
-            around_callbacks = entity.callbacks.for([:around, method])
+            around_callbacks = callbacks.for([:around, method])
 
             ##
             #
             #
-            initial_around_callback = entities.Callback.new(
+            initial_around_callback = callback_class.new(
               types: [:around, method],
               block: proc { original_value = chain.next(*args, **kwargs, &block) }
             )
@@ -132,6 +144,15 @@ module ConvenientService
 
             original_value
           end
+
+          private
+
+          ##
+          # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::CallbackCollection]
+          #
+          def callbacks
+            entity.class.callbacks
+          end
         end
       end
     end

data/lib/convenient_service/common/plugins/has_callbacks/concern.rb

@@ -7,26 +7,36 @@ module ConvenientService
         module Concern
           include Support::Concern
 
-          instance_methods do
-            include Support::Delegate
-
-            delegate :callbacks, to: :class
-          end
-
           class_methods do
             ##
             # @api private
             #
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::CallbackCollection]
+            #
             def callbacks
-              @__callbacks__ ||= Entities::CallbackCollection.new
+              internals_class.cache.fetch(:callbacks) { Entities::CallbackCollection.new }
             end
 
+            ##
+            # @api public
+            #
+            # @param type [Symbol]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
             def before(type, &block)
-              Entities::Callback.new(types: [:before, type], block: block).tap { |callback| callbacks << callback }
+              callbacks.create(types: [:before, type], block: block)
             end
 
+            ##
+            # @api public
+            #
+            # @param type [Symbol]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
             def after(type, &block)
-              Entities::Callback.new(types: [:after, type], block: block).tap { |callback| callbacks << callback }
+              callbacks.create(types: [:after, type], block: block)
             end
           end
         end

data/lib/convenient_service/common/plugins/has_callbacks/entities/callback_collection.rb

@@ -6,20 +6,68 @@ module ConvenientService
       module HasCallbacks
         module Entities
           class CallbackCollection
+            include ::Enumerable
+
             include Support::Delegate
 
+            ##
+            # @api private
+            #
+            # @!attribute [r] types
+            #   @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::TypeCollection]
+            #
             attr_reader :callbacks
 
-            delegate :each, :include?, :<<, to: :callbacks
+            ##
+            # @api private
+            #
+            # @return [Array<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+            #
+            delegate :each, to: :callbacks
 
+            ##
+            # @api private
+            #
+            # @return [void]
+            #
             def initialize
               @callbacks = []
             end
 
+            ##
+            # @return [Class<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+            #
+            def callback_class
+              Entities::Callback
+            end
+
+            ##
+            # @api private
+            #
+            # @param types [Array<Symbol>]
+            # @return [Array<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+            #
             def for(types)
               callbacks.select { |callback| callback.types.contain_exactly?(types) }
             end
 
+            ##
+            # @api private
+            #
+            # @param kwargs [Hash{Symbol => Object}]
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
+            def create(**kwargs)
+              Entities::Callback.new(**kwargs)
+                .tap { |callback| callbacks << callback }
+            end
+
+            ##
+            # @api private
+            #
+            # @param other [Object] Can be any type.
+            # @return [Boolean]
+            #
             def ==(other)
               return unless other.instance_of?(self.class)
 

data/lib/convenient_service/common/plugins/has_callbacks/middleware.rb

@@ -5,9 +5,18 @@ module ConvenientService
     module Plugins
       module HasCallbacks
         class Middleware < MethodChainMiddleware
-          intended_for any_method, scope: any_scope, entity: any_entity
+          ##
+          # @internal
+          #   TODO: Support of callbacks for class methods.
+          #
+          intended_for any_method, entity: any_entity
 
           ##
+          # @param args [Array<Object>]
+          # @param kwargs [Hash{Symbol => Object}]
+          # @param block [Proc, nil]
+          # @return [Object] Can be any type.
+          #
           # @internal
           #   TODO: Move to command.
           #
@@ -21,7 +30,7 @@ module ConvenientService
             #   end
             # end
             #
-            entity.callbacks.for([:before, method]).each { |callback| callback.call_in_context_with_arguments(entity, *args, **kwargs, &block) }
+            callbacks.for([:before, method]).each { |callback| callback.call_in_context_with_arguments(entity, *args, **kwargs, &block) }
 
             original_value = chain.next(*args, **kwargs, &block)
 
@@ -37,10 +46,19 @@ module ConvenientService
             #   end
             # end
             #
-            entity.callbacks.for([:after, method]).reverse_each { |callback| callback.call_in_context_with_value_and_arguments(entity, original_value, *args, **kwargs, &block) }
+            callbacks.for([:after, method]).reverse_each { |callback| callback.call_in_context_with_value_and_arguments(entity, original_value, *args, **kwargs, &block) }
 
             original_value
           end
+
+          private
+
+          ##
+          # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::CallbackCollection]
+          #
+          def callbacks
+            entity.class.callbacks
+          end
         end
       end
     end

data/lib/convenient_service/common/plugins/has_callbacks.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
 require_relative "has_callbacks/concern"
-require_relative "has_callbacks/container"
 require_relative "has_callbacks/entities"
 require_relative "has_callbacks/middleware"

data/lib/convenient_service/common/plugins/has_instance_proxy/entities/instance_proxy.rb

@@ -66,7 +66,7 @@ module ConvenientService
             # @return [Object] Can be any type.
             #
             def method_missing(...)
-              instance_proxy_target.public_send(...)
+              ::ConvenientService.reraise { instance_proxy_target.public_send(...) }
             end
           end
         end

data/lib/convenient_service/common/plugins/has_internals/entities/internals/plugins/has_cache/concern.rb

@@ -15,6 +15,18 @@ module ConvenientService
                 module Concern
                   include Support::Concern
 
+                  class_methods do
+                    ##
+                    # @return [ConvenientService::Support::Cache]
+                    #
+                    # @internal
+                    #   TODO: `Support::Cache.create(backend: :thread_safe_hash)`.
+                    #
+                    def cache
+                      @cache ||= Support::Cache.create(backend: :hash)
+                    end
+                  end
+
                   instance_methods do
                     ##
                     # @return [ConvenientService::Support::Cache]

data/lib/convenient_service/common/plugins.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 ##
-# NOTE: Order matters.
+# @internal
+#   NOTE: Some plugins are order-dependent.
 #
-require_relative "plugins/normalizes_env"
-
 require_relative "plugins/caches_constructor_arguments"
 require_relative "plugins/caches_return_value"
 require_relative "plugins/can_be_copied"
 require_relative "plugins/can_have_user_provided_entity"
+require_relative "plugins/ensures_negated_j_send_result"
 require_relative "plugins/has_callbacks"
 require_relative "plugins/has_around_callbacks"
 require_relative "plugins/has_constructor"

data/lib/convenient_service/core/concern/class_methods.rb

@@ -117,6 +117,9 @@ module ConvenientService
         #   - `lib/convenient_service/core/entities/config/entities/method_middlewares/entities/caller/commands/define_method_middlewares_caller.rb`
         #   - https://gist.github.com/marian13/9c25041f835564e945d978839097d419
         #
+        #   IMPORTANT: Psych has a monkey-patch `y` in IRB. That is why calling `Service.y` raise `private method called` instead of `undefined method`.
+        #   - https://github.com/ruby/psych/blob/v5.1.2/lib/psych/y.rb#L5
+        #
         def method_missing(method, *args, **kwargs, &block)
           commit_config!(trigger: Constants::Triggers::CLASS_METHOD_MISSING)
 

data/lib/convenient_service/core/entities/config/entities/concerns/entities/stack.rb

@@ -48,6 +48,23 @@ module ConvenientService
                   plain_stack.call(env)
                 end
 
+                ##
+                # @param concern [ConvenientService::Support::Concern, Module]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
+                # @return [ConvenientService::Core::Entities::Config::Entities::Concerns::Entities::Stack]
+                #
+                def unshift(concern, *args, &block)
+                  plain_stack.unshift(cast(concern), *args, &block)
+
+                  self
+                end
+
+                ##
+                # @return [ConvenientService::Core::Entities::Config::Entities::Concerns::Entities::Stack]
+                #
+                alias_method :prepend, :unshift
+
                 ##
                 # @param index_or_concern [Integer, ConvenientService::Support::Concern, Module]
                 # @param concern [ConvenientService::Support::Concern, Module]
@@ -137,6 +154,11 @@ module ConvenientService
                   self
                 end
 
+                ##
+                # @return [ConvenientService::Core::Entities::Config::Entities::Concerns::Entities::Stack]
+                #
+                alias_method :remove, :delete
+
                 ##
                 # @param concern [ConvenientService::Support::Concern, Module]
                 # @param args [Array<Object>]

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities/container/concern/instance_methods.rb

@@ -78,7 +78,7 @@ module ConvenientService
                     #   # [Service::ClassMethodsMiddlewaresCallers, #<Class:Service>, ConvenientService::Core::ClassMethods, #<Class:Object>, #<Class:BasicObject>, Class, Module, Object, Kernel, BasicObject]
                     #
                     #   ancestors_greater_than_methods_middlewares_callers # For the entity defined above.
-                    #   # [#<Class:Service>, ConvenientService::Core::ClassMethods, #<Class:Object>, #<Class:BasicObject>, Class, Module, Object, Kernel, BasicObject]# [Service::ClassMethodsMiddlewaresCallers, #<Class:Service>, ConvenientService::Core::ClassMethods, #<Class:Object>, #<Class:BasicObject>, Class, Module, Object, Kernel, BasicObject]
+                    #   # [#<Class:Service>, ConvenientService::Core::ClassMethods, #<Class:Object>, #<Class:BasicObject>, Class, Module, Object, Kernel, BasicObject]
                     #
                     # @note Returns empty array when `methods_middlewares_callers` are NOT prepended.
                     # @note If you expect to receive not empty array, make sure the config is committed.

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities/middleware_creators/observable/entities/event.rb

@@ -8,11 +8,16 @@ module ConvenientService
           class MethodMiddlewares
             module Entities
               module MiddlewareCreators
+                ##
+                # NOTE: `observer` is NOT a part of Ruby stdlib starting from Ruby 3.4. That is why a custom observer is implemented.
+                #
+                # @internal
+                #   - https://ruby-doc.org/stdlib-2.7.0/libdoc/observer/rdoc/Observable.html
+                #   - https://github.com/ruby/observer
+                #
                 class Observable < MiddlewareCreators::Base
                   module Entities
                     class Event
-                      include ::Observable
-
                       ##
                       # @!attribute [r] type
                       #   @return [Symbol]
@@ -41,7 +46,7 @@ module ConvenientService
                       # @see https://ruby-doc.org/stdlib-2.7.0/libdoc/observer/rdoc/Observable.html#method-i-add_observer
                       #
                       def add_observer(observer, func = default_handler_name)
-                        super
+                        observers[observer] = func
                       end
 
                       ##
@@ -50,10 +55,8 @@ module ConvenientService
                       # @see https://ruby-doc.org/stdlib-2.7.0/libdoc/observer/rdoc/Observable.html#method-i-changed
                       # @see https://ruby-doc.org/stdlib-2.7.0/libdoc/observer/rdoc/Observable.html#method-i-notify_observers
                       #
-                      def notify_observers(...)
-                        changed
-
-                        super
+                      def notify_observers(*args, **kwargs, &block)
+                        observers.each { |observer, method| observer.__send__(method, *args, **kwargs, &block) }
                       end
 
                       ##
@@ -64,7 +67,7 @@ module ConvenientService
                         return unless other.instance_of?(self.class)
 
                         return false if type != other.type
-                        return false if observer_peers != other.observer_peers
+                        return false if observers != other.observers
 
                         true
                       end
@@ -74,13 +77,8 @@ module ConvenientService
                       ##
                       # @return [Hash]
                       #
-                      # @see https://ruby-doc.org/stdlib-2.7.0/libdoc/observer/rdoc/Observable.html#method-i-count_observers
-                      #
-                      # @internal
-                      #   IMPORTANT: This method is using inherited private instance varaible. Ruby may change its name without any warning.
-                      #
-                      def observer_peers
-                        @observer_peers if defined? @observer_peers
+                      def observers
+                        @observers ||= {}
                       end
                     end
                   end

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities/middlewares/chain/commands/normalize_env.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Core
+    module Entities
+      class Config
+        module Entities
+          class MethodMiddlewares
+            module Entities
+              module Middlewares
+                class Chain < Middlewares::Base
+                  module Commands
+                    ##
+                    # - Single splat `*` converts `nil` to empty array.
+                    # - Double splat `**` raises on `nil`.
+                    # - Umpersand `&` converts `nil` to `nil`.
+                    #
+                    # The following middleware converts `env[:kwargs]` to a hash.
+                    # This way `__send__(:next, *env[:args], **env[:kwargs], &env[:block])` won't fail even if a user passes `nil` as `kwargs`.
+                    #
+                    # Check the following link for more details:
+                    # - https://bugs.ruby-lang.org/issues/8507
+                    #
+                    class NormalizeEnv < Support::Command
+                      ##
+                      # @!attribute [r] env
+                      #   @return [Hash, nil]
+                      #
+                      attr_reader :env
+
+                      ##
+                      # @param env [Hash, nil]
+                      # @return [void]
+                      #
+                      def initialize(env:)
+                        @env = env.to_h
+                      end
+
+                      ##
+                      # @return [Hash]
+                      #
+                      def call
+                        env.merge(args: env[:args].to_a, kwargs: env[:kwargs].to_h, block: env[:block])
+                      end
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities/middlewares/chain/commands.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
 require_relative "commands/create_observable_middleware"
+require_relative "commands/normalize_env"