feat(has_j_send_status_and_attributes): introduce Code.===

lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_j_send_status_and_attributes/entities/code/commands/is_code.rb

@@ -11,6 +11,9 @@ module HasJSendStatusAndAttributes
                 module Entities
                   class Code
                     module Commands
+                      ##
+                      # Check whether `code` can be considered as `Code` instance.
+                      #
                       class IsCode < Support::Command
                         ##
                         # @!attribute [r] code
@@ -27,7 +30,7 @@ def initialize(code:)
                         end
 
                         ##
-                        # @return [void]
+                        # @return [Boolean]
                         #
                         def call
                           code.class.include?(Entities::Code::Concern)

lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_j_send_status_and_attributes/entities/code/concern/class_methods.rb

@@ -26,6 +26,18 @@ def cast(other)
                             new(value: other.value)
                           end
                         end
+
+                        ##
+                        # @param other [Object] Can be any type.
+                        # @return [Boolean, nil]
+                        #
+                        # @internal
+                        #   NOTE: Check `Module.===` in order to get an idea of how `super` works.
+                        #   - https://ruby-doc.org/core-2.7.0/Module.html#method-i-3D-3D-3D
+                        #
+                        def ===(other)
+                          Commands::IsCode.call(code: other) || super
+                        end
                       end
                     end
                   end

spec/lib/convenient_service/service/plugins/has_result/entities/result/plugins/has_j_send_status_and_attributes/entities/code/concern/class_methods_spec.rb

@@ -6,6 +6,8 @@
 
 # rubocop:disable RSpec/NestedGroups
 RSpec.describe ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code::Concern::ClassMethods do
+  include ConvenientService::RSpec::Matchers::DelegateTo
+
   example_group "class methods" do
     describe ".cast" do
       let(:casted) { ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code.cast(other) }
@@ -45,6 +47,64 @@
         end
       end
     end
+
+    describe ".===" do
+      let(:code_class) { ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code }
+
+      let(:other) { 42 }
+
+      specify do
+        expect { code_class === other }
+          .to delegate_to(ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code::Commands::IsCode, :call)
+          .with_arguments(code: other)
+      end
+
+      it "returns `false`" do
+        expect(code_class === other).to eq(false)
+      end
+
+      context "when `other` is code instance in terms of `ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code::Commands::IsCode`" do
+        let(:service) do
+          Class.new do
+            include ConvenientService::Configs::Minimal
+
+            def result
+              success
+            end
+          end
+        end
+
+        let(:other) { service.result.code }
+
+        specify do
+          expect { code_class === other }
+            .to delegate_to(ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code::Commands::IsCode, :call)
+            .with_arguments(code: other)
+        end
+
+        it "returns `true`" do
+          expect(code_class === other).to eq(true)
+        end
+      end
+
+      context "when `other` is `ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code` instance" do
+        let(:other) { ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code.cast(:success) }
+
+        it "returns `true`" do
+          expect(code_class === other).to eq(true)
+        end
+      end
+
+      context "when `other` is `ConvenientService::Service::Plugins::HasResult::Entities::Result::Plugins::HasJSendStatusAndAttributes::Entities::Code` descendant instance" do
+        let(:descendant_class) { Class.new(code_class) }
+
+        let(:other) { descendant_class.cast(:success) }
+
+        it "returns `true`" do
+          expect(code_class === other).to eq(true)
+        end
+      end
+    end
   end
 end
 # rubocop:enable RSpec/NestedGroups