servactory 3.0.0.rc5 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 424fe07b12c6257356afa89f41e8eb1c8f093d41a97038c2ea099fbf5b971d0b
-  data.tar.gz: 2dceeed7832dbbbe9ed5826ddd6cb52e8af9950c255c81313906fb4c2c86bae1
+  metadata.gz: 1b84875a142c1878a68ea71f3874019a8028bc8eff3836706d3079107b06761b
+  data.tar.gz: 2a47fd738513716831e2fd491266e1c122a1200bcff9737d90a47087e95f2f64
 SHA512:
-  metadata.gz: d5c6d1f2b57fdffe0cd823b2ad53b405213107b6501c5cef29fc08143406929e87abee5d1689c3ec34b5fc7340c6555118a6ee2919167abc0a3efa2e551e6e34
-  data.tar.gz: 2a3c17b42d9a31edf32f11f63dbc102b511e0957b778ecffe21ff0b4374e8c5a18c68ed79092f3529d4553865ab7eb86e1007fec3671e842ff2406d2c80b811a
+  metadata.gz: 502fdff740f4a46378ee1b8664279fbc2cebfb7fe4fa01025a30499d3504ae1ae84b1ead432e28b1e23d59a572ba685690c88e681633bcb02020df5756e6328d
+  data.tar.gz: 14482adc188d556373eaa482502f2bd59533ca5a8e3d6b590109cb6cf18755c9ae34a77df79baa7d654fd0657b7202821d2983447c8485525b62445bd4ac7898

data/lib/servactory/dsl.rb

@@ -13,6 +13,10 @@ module Servactory
     end
     private_constant :STROMA
 
+    # DEPRECATED: This module is retained for backward compatibility only.
+    #             It will be removed in a future major version.
+    #             Use the Stroma-based `extensions do...end` block DSL instead,
+    #             which provides proper per-class isolation and thread-safe hook management.
     module Extensions
       def self.registry
         @registry ||= []
@@ -33,6 +37,14 @@ module Servactory
       Extensions.registry.each { |extension| base.include(extension) }
     end
 
+    # DEPRECATED: This method is retained for backward compatibility only.
+    #             It will be removed in a future major version.
+    #             Use the Stroma-based `extensions do...end` block DSL instead.
+    #
+    # WARNING: This method mutates global shared state (Extensions.registry),
+    #          which is not thread-safe. The `extensions do...end` mechanism
+    #          stores hooks per-class with deep copying on inheritance, ensuring
+    #          proper isolation across different base classes and gems.
     def self.with_extensions(*extensions)
       Extensions.clear
       Extensions.register(*extensions)

data/lib/servactory/exceptions/failure.rb

@@ -23,6 +23,26 @@ module Servactory
         @type == normalize_method_name(name) || super
       end
 
+      # Pattern matching support for nested error matching.
+      #
+      # Returns hash of error attributes for use with case/in.
+      #
+      # @param keys [Array<Symbol>, nil] Keys to include, or nil for all
+      # @return [Hash<Symbol, Object>] Hash with type, message, meta
+      #
+      # @example Nested matching in Result
+      #   case result
+      #   in { failure: true, error: { type: :validation, message: } }
+      #     flash[:error] = message
+      #   end
+      def deconstruct_keys(keys)
+        available = { type: @type, message: @message, meta: @meta }
+
+        return available if keys.nil?
+
+        available.slice(*keys)
+      end
+
       private
 
       def normalize_method_name(name)

data/lib/servactory/info/builder.rb

@@ -148,7 +148,7 @@ module Servactory
         options.merge(
           actor:,
           types: attribute.types,
-          must: must&.body
+          must: must&.value
         )
       end
     end

data/lib/servactory/maintenance/attributes/option.rb

@@ -13,7 +13,8 @@ module Servactory
                     :define_methods,
                     :define_conflicts,
                     :need_for_checks,
-                    :body
+                    :body,
+                    :body_key
 
         # rubocop:disable Metrics/MethodLength
         def initialize(
@@ -23,7 +24,7 @@ module Servactory
           need_for_checks:,
           body_fallback:,
           original_value: nil,
-          body_key: nil,
+          body_key: :is,
           body_value: true,
           define_methods: nil,
           define_conflicts: nil,
@@ -31,6 +32,7 @@ module Servactory
           **options
         )
           @name = name.to_sym
+          @body_key = body_key
           @validation_class = validation_class
           @define_methods = define_methods
           @define_conflicts = define_conflicts
@@ -49,6 +51,12 @@ module Servactory
         end
         # rubocop:enable Metrics/MethodLength
 
+        def value
+          return body unless body.is_a?(Hash)
+
+          body.fetch(@body_key, body)
+        end
+
         def need_for_checks?
           need_for_checks
         end

data/lib/servactory/maintenance/attributes/options/registrar.rb

@@ -79,6 +79,7 @@ module Servactory
               validation_class:,
               original_value: Array(@options.fetch(:type)).uniq,
               need_for_checks: true,
+              body_key: :is,
               body_fallback: nil,
               with_advanced_mode: false
             )
@@ -95,6 +96,7 @@ module Servactory
                 )
               ],
               need_for_checks: true,
+              body_key: :is,
               body_fallback: nil,
               with_advanced_mode: false
             )

data/lib/servactory/maintenance/attributes/options_collection.rb

@@ -108,12 +108,9 @@ module Servactory
         # Extracts the normalized body value from an option.
         #
         # @param option [Option] the option to extract from
-        # @return [Object] the :is value if body is a Hash with :is key, otherwise the full body
+        # @return [Object] the body_key value if body is a Hash, otherwise the full body
         def extract_normalized_body_from(option:)
-          body = option.body
-          return body unless body.is_a?(Hash)
-
-          body.key?(:is) ? body.fetch(:is) : body
+          option.value
         end
 
         # Resolves conflict codes from an option's define_conflicts.

data/lib/servactory/result.rb

@@ -70,7 +70,7 @@ module Servactory
       # when predicate_methods_enabled is true.
       #
       # @param name [Symbol] Method name (output or predicate)
-      # @param args [Array] Method arguments (unused)
+      # @param args [Array] Method arguments
       # @return [Object] Output value or predicate result
       def method_missing(name, *args)
         if name.to_s.end_with?("?")
@@ -133,9 +133,6 @@ module Servactory
 
     ############################################################################
 
-    STATE_PREDICATE_NAMES = %i[success? failure?].freeze
-    private_constant :STATE_PREDICATE_NAMES
-
     # Creates a success result for the given context.
     #
     # @param context [Object] Service execution context with outputs
@@ -222,6 +219,40 @@ module Servactory
       outputs.send(:output_names).to_h { |key| [key, outputs.public_send(key)] }.compact
     end
 
+    # Pattern matching support.
+    #
+    # Returns hash of result state and output values for use with case/in.
+    # State keys (:success, :failure, :error) take priority over output names.
+    #
+    # @param keys [Array<Symbol>, nil] Keys to include, or nil for all
+    # @return [Hash<Symbol, Object>] Hash of state and outputs for pattern matching
+    #
+    # @example Basic matching
+    #   case result
+    #   in { success: true, user: }
+    #     redirect_to user
+    #   in { failure: true }
+    #     render :error
+    #   end
+    #
+    # @example Matching with error details
+    #   case result
+    #   in { failure: true, error: { type: :validation, message: } }
+    #     flash[:error] = message
+    #   end
+    def deconstruct_keys(keys)
+      available = { success: success?, failure: failure? }
+      available[:error] = error if failure?
+
+      outputs.send(:output_names).each do |name|
+        available[name] = outputs.public_send(name)
+      end
+
+      return available if keys.nil?
+
+      available.slice(*keys)
+    end
+
     # Returns string representation for debugging.
     #
     # @return [String] Formatted result state and outputs

data/lib/servactory/version.rb

@@ -5,7 +5,7 @@ module Servactory
     MAJOR = 3
     MINOR = 0
     PATCH = 0
-    PRE = "rc5"
+    PRE = nil
 
     STRING = [MAJOR, MINOR, PATCH, PRE].compact.join(".")
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: servactory
 version: !ruby/object:Gem::Version
-  version: 3.0.0.rc5
+  version: 3.0.0
 platform: ruby
 authors:
 - Anton Sokolov
@@ -354,7 +354,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.4
 specification_version: 4
 summary: A set of tools for building reliable services of any complexity
 test_files: []