dexkit 0.6.0 → 0.7.0

data/lib/dex/operation.rb

@@ -2,6 +2,7 @@
 
 # Wrapper modules (loaded before class body so `include`/`use` can find them)
 require_relative "operation/result_wrapper"
+require_relative "operation/once_wrapper"
 require_relative "operation/record_wrapper"
 require_relative "operation/transaction_wrapper"
 require_relative "operation/lock_wrapper"
@@ -9,6 +10,7 @@ require_relative "operation/async_wrapper"
 require_relative "operation/safe_wrapper"
 require_relative "operation/rescue_wrapper"
 require_relative "operation/callback_wrapper"
+require_relative "operation/guard_wrapper"
 
 module Dex
   class Operation
@@ -40,20 +42,22 @@ module Dex
       end
     end
 
-    RESERVED_PROP_NAMES = %i[call perform async safe initialize].to_set.freeze
+    RESERVED_PROP_NAMES = %i[call perform async safe once initialize].to_set.freeze
 
     include Executable
     include PropsSetup
     include TypeCoercion
+    include ContextSetup
 
-    Contract = Data.define(:params, :success, :errors)
+    Contract = Data.define(:params, :success, :errors, :guards)
 
     class << self
       def contract
         Contract.new(
           params: _contract_params,
           success: _success_type,
-          errors: _declared_errors
+          errors: _declared_errors,
+          guards: _contract_guards
         )
       end
 
@@ -66,6 +70,14 @@ module Dex
           hash[prop.name] = prop.type
         end
       end
+
+      def _contract_guards
+        return [] unless respond_to?(:_guard_list)
+
+        _guard_list.map do |g|
+          { name: g.name, message: g.message, requires: g.requires }
+        end
+      end
     end
 
     def perform(*, **)
@@ -88,9 +100,11 @@ module Dex
     include SafeWrapper
 
     use ResultWrapper
+    use GuardWrapper
+    use OnceWrapper
     use LockWrapper
-    use TransactionWrapper
     use RecordWrapper
+    use TransactionWrapper
     use RescueWrapper
     use CallbackWrapper
   end

data/lib/dex/test_helpers/assertions.rb

@@ -214,6 +214,29 @@ module Dex
         "Expected #{model_class.name} count to increase, but it stayed at #{count_before}"
     end
 
+    # --- Guard assertions ---
+
+    def assert_callable(*args, **params)
+      klass = _dex_resolve_subject(args)
+      result = klass.callable(**params)
+      assert result.ok?, "Expected operation to be callable, but guards failed:\n#{_dex_format_err(result)}"
+      result
+    end
+
+    def refute_callable(*args, **params)
+      klass_args, codes = _dex_split_class_and_symbols(args)
+      klass = _dex_resolve_subject(klass_args)
+      code = codes.first
+      result = klass.callable(**params)
+      refute result.ok?, "Expected operation to NOT be callable, but all guards passed"
+      if code
+        failed_codes = result.details.map { |f| f[:guard] }
+        assert_includes failed_codes, code,
+          "Expected guard :#{code} to fail, but it didn't.\n  Failed guards: #{failed_codes.inspect}"
+      end
+      result
+    end
+
     # --- Batch assertions ---
 
     def assert_all_succeed(*args, params_list:)

data/lib/dex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dex
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

data/lib/dexkit.rb

@@ -14,6 +14,7 @@ require_relative "dex/concern"
 require_relative "dex/ref_type"
 require_relative "dex/type_coercion"
 require_relative "dex/props_setup"
+require_relative "dex/context_setup"
 require_relative "dex/error"
 require_relative "dex/settings"
 require_relative "dex/pipeline"
@@ -71,5 +72,20 @@ module Dex
     def transaction_adapter=(adapter)
       configuration.transaction_adapter = adapter
     end
+
+    CONTEXT_KEY = :_dex_context
+    EMPTY_CONTEXT = {}.freeze
+
+    def context
+      Fiber[CONTEXT_KEY] || EMPTY_CONTEXT
+    end
+
+    def with_context(**values)
+      previous = Fiber[CONTEXT_KEY]
+      Fiber[CONTEXT_KEY] = (previous || {}).merge(values)
+      yield
+    ensure
+      Fiber[CONTEXT_KEY] = previous
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dexkit
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Jacek Galanciak
@@ -166,6 +166,7 @@ files:
 - guides/llm/OPERATION.md
 - guides/llm/QUERY.md
 - lib/dex/concern.rb
+- lib/dex/context_setup.rb
 - lib/dex/error.rb
 - lib/dex/event.rb
 - lib/dex/event/bus.rb
@@ -186,8 +187,10 @@ files:
 - lib/dex/operation/async_proxy.rb
 - lib/dex/operation/async_wrapper.rb
 - lib/dex/operation/callback_wrapper.rb
+- lib/dex/operation/guard_wrapper.rb
 - lib/dex/operation/jobs.rb
 - lib/dex/operation/lock_wrapper.rb
+- lib/dex/operation/once_wrapper.rb
 - lib/dex/operation/outcome.rb
 - lib/dex/operation/record_backend.rb
 - lib/dex/operation/record_wrapper.rb