convenient_service 0.19.1 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c335178b5dfefbb7b3bd6cf65d1daca7d911b8f73faa8e2d485ef0be01f189a
-  data.tar.gz: a012a141e2472ec1e273aeb90f4f49cb14ce5cf858453280d88834a0da80f14b
+  metadata.gz: a82b04aed6d540c497da63b9398dc605319c95b6aeed0152edfa03c3e82f9f0d
+  data.tar.gz: 68ed1a1f53824b237f3cf322ae0130cec5ee04743368b84c536017f8d676e848
 SHA512:
-  metadata.gz: a0266947fbfa642f28247005db67bcc9b035e8ae742614880a063ae1e7f2a36853dc8c5a830990de5645845c774b77b5a69351bba6ce1e946f5858c09af4fb95
-  data.tar.gz: 93db0af41a737137a452a4bc9c60992bf32c96c637fe65d2b212200d3c776a87001046bc9d0eb2ad6f7160bc9a15454452c20235aa3ffcbc815a504558f636f7
+  metadata.gz: 4ff920321871a94fb2424e2d732574494471560fd5d2f7e97abecd44822e755f2de1b38161e5afa31da98b32ff7bd71576d50c1352ef64530ceabaf34f65e372
+  data.tar.gz: '080d31c61846cb2d53dc771708deddbd0fb84252369baa663b7a57f740d8d082cc6e4d6893bdc3f82ca92653968646c9723b319aee753bdada09d2cf935ad69f'

data/LICENSE.txt

@@ -6,4 +6,4 @@ for license text.
 
 Convenient Service Pro has a commercial-friendly license.
 You can find the commercial license in COMM-LICENSE.txt.
-Please see https://convenientservice.org for purchasing options.
+Please see http://convenientservice.org for purchasing options.

data/README.md

@@ -1,3 +1,6 @@
+<!-- AUTHOR: Marian Kostyk <mariankostyk13895@gmail.com> -->
+<!-- LICENSE: LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html> -->
+
 <!-- stand_with_ukraine:start -->
 <h1 align="center">
   #StandWithUkraine
@@ -20,10 +23,14 @@
 <!-- badges:start -->
 [![Ruby](https://img.shields.io/badge/ruby-%23CC342D.svg?style=for-the-badge&logo=ruby&logoColor=white)](https://www.ruby-lang.org/en/)
 
-[![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/)
+[![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)  ![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) [![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: LGPL-3.0](https://img.shields.io/badge/license-LGPL--3.0-yellow.svg)](https://www.gnu.org/licenses/lgpl-3.0.html)
+
+<!-- NOTE: The "Visit Count" and the "Inline Docs" badges are commented since they are failing with errors most of the time -->
+<!-- ![visitors](https://visitor-badge.glitch.me/badge?page_id=marian13/convenient_service) -->
+<!-- [![inline docs](http://inch-ci.org/github/marian13/convenient_service.svg?branch=main)](http://inch-ci.org/github/marian13/convenient_service) -->
 <!-- badges:end -->
 
 <!-- logo:start -->
@@ -40,7 +47,7 @@ Yet another approach to revisit the service object pattern, but this time focusi
 <!-- warning:start -->
 ## ❗❗❗ WARNING ❗❗❗
 
-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.
+This library is on the final stage of development before the v1.0.0 version. 90% 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 two years. The stable release is planned rather sooner than later. Less and less breaking changes are expected. 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 -->
@@ -66,10 +73,12 @@ This library is under heavy development. Most of the public API is polished, but
 
 - Have a look at [Convenient Service Development Wiki](https://github.com/marian13/convenient_service/wiki) for the contribution tutorials.
 
+- [Backlog](https://github.com/marian13/convenient_service/blob/main/BACKLOG.md).
+
 <!-- links:end -->
 
 ---
 
 <!-- author:start -->
-Copyright (c) 2022-2024 Marian Kostyk.
+Copyright (c) 2022-2025 Marian Kostyk.
 <!-- author:end -->

data/lib/convenient_service/aliases.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 ##
 # @internal
 #   NOTE: Aliases hide the full constants path from the end-users in order to increase DX.
@@ -9,4 +14,5 @@ module ConvenientService
   Command = ::ConvenientService::Support::Command
   Concern = ::ConvenientService::Support::Concern
   DependencyContainer = ::ConvenientService::Support::DependencyContainer
+  Result = ::ConvenientService::Service::Plugins::HasJSendResult::Entities::Result
 end

data/lib/convenient_service/commands.rb

@@ -1,4 +1,12 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 require_relative "commands/is_service_class"
 require_relative "commands/is_service"
+
+require_relative "commands/is_feature_class"
+require_relative "commands/is_feature"

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

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Plugins
     Common = ::ConvenientService::Common::Plugins

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_active_model_attribute_assignment/concern.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_active_model_attribute_assignment/middleware.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_active_model_attribute_assignment.rb

@@ -1,4 +1,9 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 require_relative "using_active_model_attribute_assignment/concern"
 require_relative "using_active_model_attribute_assignment/middleware"

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_dry_initializer/concern.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_dry_initializer.rb

@@ -1,3 +1,8 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 require_relative "using_dry_initializer/concern"

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

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

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

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

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

@@ -1,4 +1,9 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 require_relative "caches_constructor_arguments/concern"
 require_relative "caches_constructor_arguments/middleware"

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

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

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

@@ -1,3 +1,8 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 require_relative "caches_return_value/middleware"

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

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins

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

@@ -1,3 +1,8 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 require_relative "can_be_copied/concern"

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

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Common
+    module Plugins
+      module CanHaveCallbacks
+        module Concern
+          include Support::Concern
+
+          class_methods do
+            ##
+            # @api private
+            #
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::CallbackCollection]
+            #
+            def callbacks
+              internals_class.cache.fetch(:callbacks) { Entities::CallbackCollection.new }
+            end
+
+            ##
+            # @api public
+            #
+            # @param method [Symbol]
+            # @param kwargs [Hash{Symbol => Object}]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
+            #
+            def before(method, **kwargs, &block)
+              callback(:before, method, **kwargs, &block)
+            end
+
+            ##
+            # @api public
+            #
+            # @param method [Symbol]
+            # @param kwargs [Hash{Symbol => Object}]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
+            #
+            def after(method, **kwargs, &block)
+              callback(:after, method, **kwargs, &block)
+            end
+
+            ##
+            # @api public
+            #
+            # @param method [Symbol]
+            # @param kwargs [Hash{Symbol => Object}]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
+            #
+            def around(method, **kwargs, &block)
+              callback(:around, method, **kwargs, &block)
+            end
+
+            ##
+            # @api public
+            #
+            # @param type [Symbol]
+            # @param method [Symbol]
+            # @param kwargs [Hash{Symbol => Object}]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
+            #
+            def callback(type, method, **kwargs, &block)
+              callbacks.create(types: [type, method], block: block, **kwargs)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/common/plugins/{has_callbacks → can_have_callbacks}/entities/callback.rb

@@ -1,14 +1,19 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins
-      module HasCallbacks
+      module CanHaveCallbacks
         module Entities
           class Callback
             ##
             # @!attribute [r] types
-            #   @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::TypeCollection]
+            #   @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::TypeCollection]
             #
             attr_reader :types
 
@@ -19,27 +24,31 @@ module ConvenientService
             attr_reader :block
 
             ##
-            # @param types [ConvenientService::Common::Plugins::HasCallbacks::Entities::TypeCollection]
+            # @!attribute [r] source_location
+            #   @return [String]
+            #
+            attr_reader :source_location
+
+            ##
+            # @param types [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::TypeCollection]
             # @param block [Proc, nil]
+            # @param extra_kwargs [Hash{Symbol => Object}]
             # @return [void]
             #
-            def initialize(types:, block:)
+            def initialize(types:, block:, **extra_kwargs)
               @types = Entities::TypeCollection.new(types: types)
               @block = block
+              @source_location = extra_kwargs.fetch(:source_location) { block.source_location }
             end
 
             ##
-            # @return [Boolean]
+            # @return [String]
             #
-            def called?
-              Utils.to_bool(@called)
-            end
-
-            ##
-            # @return [Boolean]
+            # @internal
+            #   TODO: Util.
             #
-            def not_called?
-              !called?
+            def source_location_joined_by_colon
+              source_location.join(":")
             end
 
             ##
@@ -66,7 +75,7 @@ module ConvenientService
 
             ##
             # @param context [Object] Can be any type.
-            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
             #
             def call_in_context(context)
               call_callback_in_context(context)
@@ -77,7 +86,7 @@ module ConvenientService
             # @param args [Array<Object>]
             # @param kwargs [Hash{Symbol => Object}]
             # @param block [Proc, nil]
-            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
             #
             def call_in_context_with_arguments(context, *args, **kwargs, &block)
               call_callback_in_context(context, arguments(*args, **kwargs, &block))
@@ -89,7 +98,7 @@ module ConvenientService
             # @param args [Array<Object>]
             # @param kwargs [Hash{Symbol => Object}]
             # @param block [Proc, nil]
-            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
             #
             def call_in_context_with_value_and_arguments(context, value, *args, **kwargs, &block)
               call_callback_in_context(context, value, arguments(*args, **kwargs, &block))
@@ -97,13 +106,14 @@ module ConvenientService
 
             ##
             # @param other [Object] Can be any type.
-            # @return [Boolead]
+            # @return [Boolean, nil]
             #
             def ==(other)
               return unless other.instance_of?(self.class)
 
               return false if types != other.types
-              return false if block&.source_location != other.block&.source_location
+              return false if block != other.block
+              return false if source_location != other.source_location
 
               true
             end
@@ -117,13 +127,6 @@ module ConvenientService
 
             private
 
-            ##
-            # @return [Boolean]
-            #
-            def mark_as_called
-              @called = true
-            end
-
             ##
             # @return [ConvenientService::Support::Arguments]
             #
@@ -135,14 +138,16 @@ module ConvenientService
             # @return [Object] Can be any type.
             #
             def call_callback(...)
-              block.call(...).tap { mark_as_called }
+              block.call(...)
             end
 
             ##
+            # @param context [Object] Can be any type.
+            # @param args [Array<Object>]
             # @return [Object] Can be any type.
             #
             def call_callback_in_context(context, *args)
-              context.instance_exec(*args, &block).tap { mark_as_called }
+              context.instance_exec(*args, &block)
             end
           end
         end

data/lib/convenient_service/common/plugins/{has_callbacks → can_have_callbacks}/entities/callback_collection.rb

@@ -1,9 +1,14 @@
 # frozen_string_literal: true
 
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
 module ConvenientService
   module Common
     module Plugins
-      module HasCallbacks
+      module CanHaveCallbacks
         module Entities
           class CallbackCollection
             include ::Enumerable
@@ -13,15 +18,15 @@ module ConvenientService
             ##
             # @api private
             #
-            # @!attribute [r] types
-            #   @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::TypeCollection]
+            # @!attribute [r] callbacks
+            #   @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::TypeCollection]
             #
             attr_reader :callbacks
 
             ##
             # @api private
             #
-            # @return [Array<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+            # @return [Array<ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback>]
             #
             delegate :each, to: :callbacks
 
@@ -35,7 +40,7 @@ module ConvenientService
             end
 
             ##
-            # @return [Class<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+            # @return [Class<ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback>]
             #
             def callback_class
               Entities::Callback
@@ -45,7 +50,7 @@ module ConvenientService
             # @api private
             #
             # @param types [Array<Symbol>]
-            # @return [Array<ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback>]
+            # @return [Array<ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback>]
             #
             def for(types)
               callbacks.select { |callback| callback.types.contain_exactly?(types) }
@@ -55,7 +60,7 @@ module ConvenientService
             # @api private
             #
             # @param kwargs [Hash{Symbol => Object}]
-            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Callback]
             #
             def create(**kwargs)
               Entities::Callback.new(**kwargs)
@@ -66,7 +71,7 @@ module ConvenientService
             # @api private
             #
             # @param other [Object] Can be any type.
-            # @return [Boolean]
+            # @return [Boolean, nil]
             #
             def ==(other)
               return unless other.instance_of?(self.class)

data/lib/convenient_service/common/plugins/can_have_callbacks/entities/type/concern.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+module ConvenientService
+  module Common
+    module Plugins
+      module CanHaveCallbacks
+        module Entities
+          class Type
+            module Concern
+              include Support::Concern
+
+              class_methods do
+                ##
+                # @param other [Object] Can be any type.
+                # @return [ConvenientService::Common::Plugins::CanHaveCallbacks::Entities::Type, nil]
+                #
+                def cast(other)
+                  case other
+                  when ::Symbol
+                    Type.new(value: other)
+                  when ::String
+                    Type.new(value: other.to_sym)
+                  when Type
+                    Type.new(value: other.value)
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/common/plugins/can_have_callbacks/entities/type.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+##
+# @author Marian Kostyk <mariankostyk13895@gmail.com>
+# @license LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>
+##
+
+require_relative "type/concern"
+
+module ConvenientService
+  module Common
+    module Plugins
+      module CanHaveCallbacks
+        module Entities
+          class Type
+            include Support::Castable
+            include Support::Delegate
+
+            include Concern
+
+            ##
+            # @!attribute [r] value
+            #   @return [Symbol]
+            #
+            attr_reader :value
+
+            ##
+            # @param value [Symbol]
+            # @return [void]
+            #
+            def initialize(value:)
+              @value = value
+            end
+
+            ##
+            # @param other [Object] Can be any type.
+            # @return [Boolean, nil]
+            #
+            def ==(other)
+              return unless other.instance_of?(self.class)
+
+              return false if value != other.value
+
+              true
+            end
+
+            ##
+            # @param other [Object] Can be any type.
+            # @return [Boolean, nil]
+            #
+            # @internal
+            #   NOTE: Used by `contain_exactly`. Check its specs.
+            #
+            #   NOTE: This method is intented to be used only for hash keys comparison,
+            #   when you know for sure that `other` is always an `Entities::Type` instance.
+            #
+            #   IMPORTANT: Do NOT use `eql?` without a strong reason, prefer `==`.
+            #
+            #   IMPORTANT: Do NOT delegate to `==` from `eql?`. When user overrides `==` then it can break `eql?`.
+            #   - https://shopify.engineering/implementing-equality-in-ruby
+            #   - https://github.com/ruby/ruby/blob/v3_3_0/hash.c#L3719
+            #   - https://belighted.com/blog/overriding-equals-equals
+            #
+            def eql?(other)
+              return unless other.instance_of?(self.class)
+
+              return false if value != other.value
+
+              true
+            end
+
+            ##
+            # @return [Integer]
+            #
+            # @internal
+            #   NOTE: Common way to implement hash.
+            #   - https://shopify.engineering/implementing-equality-in-ruby
+            #
+            def hash
+              [self.class, value].hash
+            end
+          end
+        end
+      end
+    end
+  end
+end