servactory 3.0.0.rc1 → 3.0.0.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a81d492854b21f7fec57aae3bfea4093da15b1e1ffb3cad330761983471bc39c
-  data.tar.gz: 54500fceb644df98c89d66d25ab53d9bc0317d0bde0f8216be364aaa630a710a
+  metadata.gz: eee9fc6bec95dd20ef1a266e76789505c2047fdcefb762537cda444bfcf0aa41
+  data.tar.gz: ff045dc86733a26574bb47b37476b9efcf57736b2f269e24a5799d4abdeec0f3
 SHA512:
-  metadata.gz: 695eceb38259b25d69e04a2614256a65be9e49ee1b7ea56064cb67f9e11e2a71143545bedaa37d3d669897d3d36091416f1d98a2ca1606c556391801275ecd19
-  data.tar.gz: b4550c2c7c995049df7be5d6291e5b2f381b0647317b236d7cce91254f61fdbdbd29400cdbeb993da2bd63df88244c259eb26a6d662483b711ad3bebfd94d043
+  metadata.gz: 9f32384fffa078eb57863ca1b7f4fee8d79ee8018bb9ccb5e928577df062e94cfe9781ee6dbb45efc06887e8d845c3c2e634295a2f331c9e10443d56ba523e2e
+  data.tar.gz: d177b88839a2ea979eaca67c4cb97fbcbfe554aa9add0be2308301715539c528a5fb024427f7cda6d15622016f0a184d88a7ce8862e40b942e18eed2502e27a3

data/lib/servactory/dsl.rb

@@ -16,17 +16,17 @@ module Servactory
       end
     end
 
-    Stroma::Registry.register(:configuration, Configuration::DSL)
-    Stroma::Registry.register(:info, Info::DSL)
-    Stroma::Registry.register(:context, Context::DSL)
-    Stroma::Registry.register(:inputs, Inputs::DSL)
-    Stroma::Registry.register(:internals, Internals::DSL)
-    Stroma::Registry.register(:outputs, Outputs::DSL)
-    Stroma::Registry.register(:actions, Actions::DSL)
-    Stroma::Registry.finalize!
+    ::Stroma::Registry.register(:configuration, Configuration::DSL)
+    ::Stroma::Registry.register(:info, Info::DSL)
+    ::Stroma::Registry.register(:context, Context::DSL)
+    ::Stroma::Registry.register(:inputs, Inputs::DSL)
+    ::Stroma::Registry.register(:internals, Internals::DSL)
+    ::Stroma::Registry.register(:outputs, Outputs::DSL)
+    ::Stroma::Registry.register(:actions, Actions::DSL)
+    ::Stroma::Registry.finalize!
 
     def self.included(base)
-      base.include(Stroma::DSL)
+      base.include(::Stroma::DSL)
 
       Extensions.registry.each { |extension| base.include(extension) }
     end

data/lib/servactory/tool_kit/dynamic_options/target.rb

@@ -3,15 +3,15 @@
 module Servactory
   module ToolKit
     module DynamicOptions
-      # Validates that attribute value matches one of the target values.
+      # Validates that Class-typed attribute value matches one of the target classes.
       #
       # ## Purpose
       #
-      # Target provides exact value matching validation for attributes.
-      # It ensures that the value is one of the specified target values,
-      # supporting both single values and arrays of acceptable values.
-      # This is useful for enum-like validations where only specific
-      # values are allowed.
+      # Target provides class matching validation for Class-typed attributes.
+      # It ensures that the passed class is one of the specified target classes,
+      # supporting both single class and arrays of acceptable classes.
+      # This is useful for validating service classes, strategy patterns,
+      # or any scenario where specific classes are expected.
       #
       # ## Usage
       #
@@ -38,22 +38,18 @@ module Servactory
       #
       # ```ruby
       # class ProcessOrderService < ApplicationService::Base
-      #   input :status, type: Symbol, target: { in: [:pending, :processing, :complete] }
-      #   input :priority, type: Integer, target: { in: [1, 2, 3] }
-      #   input :model_class, type: Class, target: { in: [User, Admin] }
+      #   input :service_class, type: Class, target: UserService
+      #   input :handler_class, type: Class, target: [CreateHandler, UpdateHandler]
       # end
       # ```
       #
       # ## Simple Mode
       #
-      # Specify target values directly:
+      # Specify target class directly or as an array:
       #
       # ```ruby
-      # class ProcessOrderService < ApplicationService::Base
-      #   input :status, type: Symbol, target: :pending
-      #   input :priority, type: Integer, target: [1, 2, 3]
-      #   input :model_class, type: Class, target: [User, Admin]
-      # end
+      # input :service_class, type: Class, target: UserService
+      # input :handler_class, type: Class, target: [CreateHandler, UpdateHandler]
       # ```
       #
       # ## Advanced Mode
@@ -64,19 +60,19 @@ module Servactory
       # With static message:
       #
       # ```ruby
-      # input :status, type: Symbol, target: {
-      #   in: [:pending, :processing, :complete],
-      #   message: "Input `status` must be one of: pending, processing, complete"
+      # input :handler_class, type: Class, target: {
+      #   in: [CreateHandler, UpdateHandler],
+      #   message: "Input `handler_class` must be one of: CreateHandler, UpdateHandler"
       # }
       # ```
       #
       # With dynamic lambda message:
       #
       # ```ruby
-      # input :status, type: Symbol, target: {
-      #   in: [:pending, :processing, :complete],
+      # input :handler_class, type: Class, target: {
+      #   in: [CreateHandler, UpdateHandler],
       #   message: lambda do |input:, value:, option_value:, **|
-      #     "Input `#{input.name}` has invalid value `#{value}`, expected: #{option_value.inspect}"
+      #     "Input `#{input.name}` received `#{value}`, expected: #{Array(option_value).map(&:name).join(', ')}"
       #   end
       # }
       # ```
@@ -88,8 +84,8 @@ module Servactory
       #
       # ## Validation Rules
       #
-      # - Value must exactly match one of the target values
-      # - Supports single value or array of values
+      # - Class must exactly match one of the target classes
+      # - Supports single class or array of classes
       # - Optional inputs with nil value validate against default
       #
       # ## Important Notes

data/lib/servactory/version.rb

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

data/lib/servactory.rb

@@ -2,6 +2,8 @@
 
 require "zeitwerk"
 
+require "stroma"
+
 require "active_support/all"
 
 require "uri"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: servactory
 version: !ruby/object:Gem::Version
-  version: 3.0.0.rc1
+  version: 3.0.0.rc2
 platform: ruby
 authors:
 - Anton Sokolov
@@ -23,34 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '5.1'
-- !ruby/object:Gem::Dependency
-  name: base64
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: bigdecimal
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
@@ -66,7 +38,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.14'
 - !ruby/object:Gem::Dependency
-  name: mutex_m
+  name: stroma
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -312,23 +284,6 @@ files:
 - lib/servactory/outputs/dsl.rb
 - lib/servactory/outputs/output.rb
 - lib/servactory/result.rb
-- lib/servactory/stroma/dsl.rb
-- lib/servactory/stroma/entry.rb
-- lib/servactory/stroma/exceptions/base.rb
-- lib/servactory/stroma/exceptions/invalid_hook_type.rb
-- lib/servactory/stroma/exceptions/key_already_registered.rb
-- lib/servactory/stroma/exceptions/registry_frozen.rb
-- lib/servactory/stroma/exceptions/registry_not_finalized.rb
-- lib/servactory/stroma/exceptions/unknown_hook_target.rb
-- lib/servactory/stroma/hooks/applier.rb
-- lib/servactory/stroma/hooks/collection.rb
-- lib/servactory/stroma/hooks/factory.rb
-- lib/servactory/stroma/hooks/hook.rb
-- lib/servactory/stroma/registry.rb
-- lib/servactory/stroma/settings/collection.rb
-- lib/servactory/stroma/settings/registry_settings.rb
-- lib/servactory/stroma/settings/setting.rb
-- lib/servactory/stroma/state.rb
 - lib/servactory/test_kit/fake_type.rb
 - lib/servactory/test_kit/result.rb
 - lib/servactory/test_kit/rspec/helpers.rb

data/lib/servactory/stroma/dsl.rb

@@ -1,118 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    # Main integration point between Stroma and service classes.
-    #
-    # ## Purpose
-    #
-    # Module that provides the core Stroma functionality to service classes:
-    # - Includes all registered DSL modules
-    # - Provides extensions block for hook registration
-    # - Handles inheritance with proper state copying
-    #
-    # ## Usage
-    #
-    # ```ruby
-    # class MyService
-    #   include Servactory::Stroma::DSL
-    #
-    #   extensions do
-    #     before :actions, MyExtension
-    #   end
-    # end
-    # ```
-    #
-    # ## Extension Settings Access
-    #
-    # Extensions access their settings through the stroma.settings hierarchy:
-    #
-    # ```ruby
-    # # In ClassMethods:
-    # stroma.settings[:actions][:authorization][:method_name] = :authorize
-    #
-    # # In InstanceMethods:
-    # self.class.stroma.settings[:actions][:authorization][:method_name]
-    # ```
-    #
-    # ## Integration
-    #
-    # Included by Servactory::DSL which is included by Servactory::Base.
-    # Provides ClassMethods with: stroma, inherited, extensions.
-    module DSL
-      def self.included(base)
-        base.extend(ClassMethods)
-
-        Registry.entries.each do |entry|
-          base.include(entry.extension)
-        end
-      end
-
-      # Class-level methods for Stroma integration.
-      #
-      # ## Purpose
-      #
-      # Provides access to Stroma state and hooks DSL at the class level.
-      # Handles proper duplication during inheritance.
-      #
-      # ## Key Methods
-      #
-      # - `stroma` - Access the State container
-      # - `inherited` - Copy state to child classes
-      # - `extensions` - DSL block for hook registration
-      module ClassMethods
-        def self.extended(base)
-          base.instance_variable_set(:@stroma, State.new)
-        end
-
-        # Handles inheritance by duplicating Stroma state.
-        #
-        # Creates an independent copy of hooks and settings for the child class,
-        # then applies all registered hooks to the child.
-        #
-        # @param child [Class] The child class being created
-        # @return [void]
-        def inherited(child)
-          super
-
-          child.instance_variable_set(:@stroma, stroma.dup)
-
-          Hooks::Applier.new(child, child.stroma.hooks).apply!
-        end
-
-        # Returns the Stroma state for this service class.
-        #
-        # @return [State] The Stroma state container
-        #
-        # @example Accessing hooks
-        #   stroma.hooks.before(:actions)
-        #
-        # @example Accessing settings
-        #   stroma.settings[:actions][:authorization][:method_name]
-        def stroma
-          @stroma ||= State.new
-        end
-
-        private
-
-        # DSL block for registering hooks.
-        #
-        # Evaluates the block in the context of a Hooks::Factory,
-        # allowing before/after hook registration.
-        #
-        # @yield Block with before/after DSL calls
-        # @return [void]
-        #
-        # @example
-        #   extensions do
-        #     before :actions, AuthorizationExtension
-        #     after :outputs, LoggingExtension
-        #   end
-        def extensions(&block)
-          @stroma_hooks_factory ||= Hooks::Factory.new(stroma.hooks)
-          @stroma_hooks_factory.instance_eval(&block)
-        end
-      end
-    end
-  end
-end

data/lib/servactory/stroma/entry.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    # Represents a registered DSL entry in the Stroma registry.
-    #
-    # ## Purpose
-    #
-    # Immutable value object that holds information about a DSL module
-    # registered in the Stroma system. Each entry has a unique key
-    # and references a Module that will be included in service classes.
-    #
-    # ## Attributes
-    #
-    # - `key` (Symbol): Unique identifier for the DSL module (:inputs, :outputs, :actions)
-    # - `extension` (Module): The actual DSL module to be included
-    #
-    # ## Usage
-    #
-    # Entries are created internally by Registry.register:
-    #
-    # ```ruby
-    # Stroma::Registry.register(:inputs, Servactory::Inputs::DSL)
-    # # Creates: Entry.new(key: :inputs, extension: Servactory::Inputs::DSL)
-    # ```
-    #
-    # ## Immutability
-    #
-    # Entry is immutable (Data object) - once created, it cannot be modified.
-    Entry = Data.define(:key, :extension)
-  end
-end

data/lib/servactory/stroma/exceptions/base.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Exceptions
-      # Base exception class for all Stroma-specific exceptions
-      #
-      # ## Purpose
-      #
-      # Serves as the parent class for all custom exceptions in the Stroma subsystem.
-      # Allows catching all Stroma-related exceptions with a single rescue clause.
-      #
-      # ## Usage
-      #
-      # All Stroma exceptions inherit from this base class:
-      #
-      # ```ruby
-      # begin
-      #   Servactory::Stroma::Registry.register(:custom, CustomModule)
-      # rescue Servactory::Stroma::Exceptions::Base => e
-      #   # Catches any Stroma-specific exception
-      #   handle_stroma_error(e)
-      # end
-      # ```
-      #
-      # ## Integration
-      #
-      # Can be used in application error handlers for centralized error handling:
-      #
-      # ```ruby
-      # rescue_from Servactory::Stroma::Exceptions::Base, with: :handle_stroma_error
-      # ```
-      #
-      # ## Subclasses
-      #
-      # - RegistryFrozen - Raised when modifying a finalized registry
-      # - RegistryNotFinalized - Raised when accessing registry before finalization
-      # - KeyAlreadyRegistered - Raised when registering a duplicate key
-      # - UnknownHookTarget - Raised when using an invalid hook target key
-      # - InvalidHookType - Raised when using an invalid hook type (:before/:after)
-      class Base < StandardError
-      end
-    end
-  end
-end

data/lib/servactory/stroma/exceptions/invalid_hook_type.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Exceptions
-      # Raised when an invalid hook type is provided.
-      #
-      # ## Purpose
-      #
-      # Ensures that only valid hook types (:before, :after) are used
-      # when creating Servactory::Stroma::Hooks::Hook objects. Provides fail-fast
-      # behavior during class definition rather than silent failures at runtime.
-      #
-      # ## Usage
-      #
-      # ```ruby
-      # # This will raise InvalidHookType:
-      # Servactory::Stroma::Hooks::Hook.new(
-      #   type: :invalid,
-      #   target_key: :actions,
-      #   extension: MyModule
-      # )
-      # # => Servactory::Stroma::Exceptions::InvalidHookType:
-      # #    Invalid hook type: :invalid. Valid types: :before, :after
-      # ```
-      class InvalidHookType < Base; end
-    end
-  end
-end

data/lib/servactory/stroma/exceptions/key_already_registered.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Exceptions
-      # Raised when registering a duplicate key in the registry
-      #
-      # ## Purpose
-      #
-      # Indicates that a DSL module key has already been registered.
-      # Each DSL module must have a unique key in the registry.
-      #
-      # ## Usage
-      #
-      # Raised when attempting to register a duplicate key:
-      #
-      # ```ruby
-      # Servactory::Stroma::Registry.register(:inputs, Inputs::DSL)
-      # Servactory::Stroma::Registry.register(:inputs, AnotherModule)
-      # # Raises: Servactory::Stroma::Exceptions::KeyAlreadyRegistered
-      # ```
-      #
-      # ## Integration
-      #
-      # This exception typically indicates a configuration error - each
-      # DSL module should only be registered once. Check for duplicate
-      # registrations in your initialization code.
-      class KeyAlreadyRegistered < Base
-      end
-    end
-  end
-end

data/lib/servactory/stroma/exceptions/registry_frozen.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Exceptions
-      # Raised when attempting to modify a finalized registry
-      #
-      # ## Purpose
-      #
-      # Indicates that the Stroma::Registry has been finalized and cannot accept
-      # new module registrations. The registry is finalized once during gem
-      # initialization and remains immutable thereafter.
-      #
-      # ## Usage
-      #
-      # Raised when attempting to register modules after finalize!:
-      #
-      # ```ruby
-      # Servactory::Stroma::Registry.finalize!
-      # Servactory::Stroma::Registry.register(:custom, CustomModule)
-      # # Raises: Servactory::Stroma::Exceptions::RegistryFrozen
-      # ```
-      #
-      # ## Integration
-      #
-      # This exception typically indicates a programming error - module
-      # registration should only occur during application boot, before
-      # any service classes are defined.
-      class RegistryFrozen < Base
-      end
-    end
-  end
-end

data/lib/servactory/stroma/exceptions/registry_not_finalized.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Exceptions
-      # Raised when accessing registry before finalization
-      #
-      # ## Purpose
-      #
-      # Indicates that the Stroma::Registry was accessed before finalize! was called.
-      # The registry must be finalized before it can be used to ensure all DSL modules
-      # are registered in the correct order.
-      #
-      # ## Usage
-      #
-      # Raised when accessing registry methods before finalization:
-      #
-      # ```ruby
-      # # Before finalize! is called
-      # Servactory::Stroma::Registry.entries
-      # # Raises: Servactory::Stroma::Exceptions::RegistryNotFinalized
-      # ```
-      #
-      # ## Integration
-      #
-      # This exception typically indicates that Servactory::DSL module was not
-      # properly loaded. Ensure servactory gem is properly required before
-      # defining service classes.
-      class RegistryNotFinalized < Base
-      end
-    end
-  end
-end

data/lib/servactory/stroma/exceptions/unknown_hook_target.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Exceptions
-      # Raised when using an invalid hook target key
-      #
-      # ## Purpose
-      #
-      # Indicates that an unknown key was used as a hook target in the
-      # extensions block. Only registered DSL module keys can be used
-      # as hook targets.
-      #
-      # ## Usage
-      #
-      # Raised when using an invalid key in extensions block:
-      #
-      # ```ruby
-      # class ApplicationService::Base
-      #   include Servactory::DSL
-      #
-      #   extensions do
-      #     before :unknown_key, SomeModule
-      #     # Raises: Servactory::Stroma::Exceptions::UnknownHookTarget
-      #   end
-      # end
-      # ```
-      #
-      # ## Integration
-      #
-      # Valid hook target keys are determined by registered DSL modules:
-      # :configuration, :info, :context, :inputs, :internals, :outputs, :actions
-      #
-      # Check Servactory::Stroma::Registry.keys for the list of valid targets.
-      class UnknownHookTarget < Base
-      end
-    end
-  end
-end

data/lib/servactory/stroma/hooks/applier.rb

@@ -1,63 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Stroma
-    module Hooks
-      # Applies registered hooks to a target class.
-      #
-      # ## Purpose
-      #
-      # Iterates through all registered DSL modules and includes corresponding
-      # before/after hooks in the target class. For each registry entry,
-      # before hooks are included first, then after hooks.
-      #
-      # ## Usage
-      #
-      # ```ruby
-      # applier = Servactory::Stroma::Hooks::Applier.new(ChildService, hooks)
-      # applier.apply!
-      # # ChildService now includes all hook modules
-      # ```
-      #
-      # ## Integration
-      #
-      # Called by Servactory::Stroma::DSL.inherited after duplicating
-      # parent's configuration. Uses Registry.entries to determine
-      # hook application order.
-      class Applier
-        # Creates a new applier for applying hooks to a class.
-        #
-        # @param target_class [Class] The class to apply hooks to
-        # @param hooks [Collection] The hooks collection to apply
-        def initialize(target_class, hooks)
-          @target_class = target_class
-          @hooks = hooks
-        end
-
-        # Applies all registered hooks to the target class.
-        #
-        # For each registry entry, includes before hooks first,
-        # then after hooks. Does nothing if hooks collection is empty.
-        #
-        # @return [void]
-        #
-        # @example
-        #   applier.apply!
-        #   # Target class now includes all extension modules
-        def apply!
-          return if @hooks.empty?
-
-          Registry.entries.each do |entry|
-            @hooks.before(entry.key).each do |hook|
-              @target_class.include(hook.extension)
-            end
-
-            @hooks.after(entry.key).each do |hook|
-              @target_class.include(hook.extension)
-            end
-          end
-        end
-      end
-    end
-  end
-end