bcdd-result 0.11.0 → 0.13.0

data/sig/bcdd/result/ignored_types.rbs

@@ -0,0 +1,9 @@
+class BCDD::Result
+  module IgnoredTypes
+    LIST: ::Set[::Symbol]
+    GIVEN: ::Symbol
+    CONTINUE: ::Symbol
+
+    def self.include?: (::Symbol) -> bool
+  end
+end

data/sig/bcdd/result/transitions.rbs

@@ -1,5 +1,82 @@
 class BCDD::Result
   module Transitions
+    module Listener
+      module ClassMethods
+        def around_and_then?: () -> bool
+        def around_transitions?: () -> bool
+      end
+
+      extend ClassMethods
+
+      def around_transitions: (scope: Hash[Symbol, untyped]) { () -> untyped } -> untyped
+
+      def on_start: (scope: Hash[Symbol, untyped]) -> untyped
+
+      def around_and_then: (scope: Hash[Symbol, untyped], and_then: Hash[Symbol, untyped]) { () -> untyped } -> untyped
+
+      def on_record: (record: Hash[Symbol, untyped] ) -> untyped
+
+      def on_finish: (transitions: Hash[Symbol, untyped] ) -> untyped
+
+      def before_interruption: (exception: ::Exception, transitions: Hash[Symbol, untyped]) -> untyped
+    end
+
+    class Listeners
+      class Chain
+        include Listener
+
+        attr_reader listeners: Hash[Symbol, untyped]
+
+        def initialize: (Array[untyped]) -> void
+
+        def new: () -> Listeners
+
+        private
+
+        def listener?: (untyped, untyped) -> bool
+      end
+
+      def self.[]: (*untyped) -> Chain
+
+      private attr_reader listeners: Array[Listener]
+      private attr_reader around_and_then_listener: untyped
+      private attr_reader around_transitions_listener: untyped
+
+      def initialize: (Array[Listener], untyped, untyped) -> void
+
+      def around_transitions: (scope: Hash[Symbol, untyped]) { () -> untyped } -> untyped
+
+      def on_start: (scope: Hash[Symbol, untyped]) -> untyped
+
+      def around_and_then: (scope: Hash[Symbol, untyped], and_then: Hash[Symbol, untyped]) { () -> untyped } -> untyped
+
+      def on_record: (record: Hash[Symbol, untyped] ) -> untyped
+
+      def on_finish: (transitions: Hash[Symbol, untyped] ) -> untyped
+
+      def before_interruption: (exception: ::Exception, transitions: Hash[Symbol, untyped]) -> untyped
+    end
+
+    module Listener::Null
+      extend Listener
+
+      def self.new: () -> untyped
+    end
+
+    class Config
+      include ::Singleton
+
+      attr_reader listener: untyped
+      attr_reader trace_id: ::Proc
+
+      def self.instance: -> Config
+
+      def initialize: -> void
+
+      def listener=: (Listener) -> void
+      def trace_id=: (::Proc) -> void
+    end
+
     class Tree
       class Node
         attr_reader id: Integer
@@ -32,7 +109,8 @@ class BCDD::Result
       def parent_value: () -> untyped
       def current_value: () -> untyped
       def insert: (untyped) -> Node
-      def insert!: (untyped) -> Node
+      def insert!: (untyped) -> Tree
+      def move_to!: (Node) -> Tree
       def move_up!: (?Integer level) -> Tree
       def move_down!: (?Integer level) -> Tree
       def move_to_root!: () -> Tree
@@ -40,6 +118,10 @@ class BCDD::Result
       NestedIds: ^(Node) -> Array[untyped]
 
       def nested_ids: () -> Array[untyped]
+
+      IdsMatrix: ::Proc
+
+      def ids_matrix: () -> untyped
     end
 
     module Tracking
@@ -52,31 +134,47 @@ class BCDD::Result
       class Enabled
         private attr_accessor tree: Transitions::Tree
         private attr_accessor records: Array[Hash[Symbol, untyped]]
+        private attr_accessor listener: untyped
         private attr_accessor root_started_at: Integer
 
-        def start: (name: String, desc: String) -> void
-        def finish: (result: BCDD::Result) -> void
+        def exec: (untyped, untyped) { () -> untyped } -> untyped
+        def err!: (::Exception, untyped) -> void
         def reset!: () -> void
         def record: (BCDD::Result) -> void
-        def record_and_then: ((untyped), untyped, untyped) { () -> BCDD::Result } -> BCDD::Result
+        def record_and_then: ((untyped), untyped) { () -> untyped } -> untyped
+        def reset_and_then!: () -> void
 
         private
 
+        def start: (String, String) -> [Transitions::Tree::Node, Hash[Symbol, untyped]]
+        def finish: (untyped) -> untyped
+
         TreeNodeValueNormalizer: ^(Integer, Array[untyped]) -> untyped
 
         def root_start: (Array[untyped]) -> void
 
         def track: (BCDD::Result, time: Time) -> void
+        def track_record: (BCDD::Result, Time) -> Hash[Symbol, untyped]
 
         def now_in_milliseconds: () -> Integer
+
+        def map_transitions: () -> Hash[Symbol, untyped]
+
+        def build_listener: () -> Listener
       end
 
       module Disabled
-        def self.start: (name: String, desc: String) -> void
-        def self.finish: (result: BCDD::Result) -> void
+        def self.exec: (untyped, untyped) { () -> untyped } -> untyped
+        def self.err!: (::Exception) -> void
         def self.reset!: () -> void
         def self.record: (BCDD::Result) -> void
-        def self.record_and_then: ((untyped), untyped, untyped) { () -> BCDD::Result } -> BCDD::Result
+        def self.record_and_then: ((untyped), untyped) { () -> BCDD::Result } -> BCDD::Result
+        def self.reset_and_then!: () -> void
+
+        private
+
+        def self.start: (String, String) -> void
+        def self.finish: (untyped) -> untyped
       end
 
       def self.instance: () -> (Enabled | singleton(Disabled))
@@ -84,6 +182,8 @@ class BCDD::Result
 
     THREAD_VAR_NAME: Symbol
 
+    EnsureResult: ^(untyped) -> BCDD::Result
+
     def self.tracking: () -> (Tracking::Enabled | singleton(Tracking::Disabled))
   end
 end

data/sig/bcdd/result.rbs

@@ -4,17 +4,18 @@ class BCDD::Result
   private attr_reader type_checker: BCDD::Result::Contract::TypeChecker
 
   attr_reader data: BCDD::Result::Data
-  attr_reader subject: untyped
+  attr_reader source: untyped
   attr_reader terminal: bool
   attr_reader transitions: Hash[Symbol, untyped]
 
   def self.config: -> BCDD::Result::Config
-  def self.configuration: { (BCDD::Result::Config) -> void } -> BCDD::Result::Config
+  def self.configuration: (freeze: bool) { (BCDD::Result::Config) -> void } -> (bool | BCDD::Result::Config)
+  def self.transitions: (name: untyped, desc: untyped) { () -> untyped } -> BCDD::Result
 
   def initialize: (
     type: Symbol,
     value: untyped,
-    ?subject: untyped,
+    ?source: untyped,
     ?expectations: BCDD::Result::Contract::Evaluator,
     ?terminal: bool
   ) -> void
@@ -33,7 +34,9 @@ class BCDD::Result
   def on_failure: (*Symbol) { (untyped, Symbol) -> void } -> BCDD::Result
   def on_unknown: () { (untyped, Symbol) -> void } -> BCDD::Result
 
-  def and_then: (?Symbol method_name, ?untyped context) ?{ (untyped) -> untyped } -> untyped
+  def and_then: (?Symbol method_name, ?untyped injected_value) ?{ (untyped) -> untyped } -> untyped
+
+  def and_then!: (untyped, ?untyped injected_value, _call: (Symbol | nil)) -> untyped
 
   def handle: () { (BCDD::Result::Handler) -> void } -> untyped
 
@@ -51,10 +54,11 @@ class BCDD::Result
 
   def kind: -> Symbol
   def known: (Proc) -> untyped
-  def call_and_then_subject_method: (Symbol, untyped) -> BCDD::Result
-  def call_and_then_subject_method!: (untyped, untyped) -> BCDD::Result
+  def call_and_then_source_method: (Symbol, untyped) -> BCDD::Result
+  def call_and_then_source_method!: (untyped, untyped) -> BCDD::Result
   def call_and_then_block: (untyped) -> BCDD::Result
   def call_and_then_block!: (untyped) -> BCDD::Result
+  def call_and_then_callable!: (untyped, value: untyped, injected_value: untyped, method_name: (Symbol | nil)) -> BCDD::Result
   def ensure_result_object: (untyped, origin: Symbol) -> BCDD::Result
 end
 

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: bcdd-result
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Rodrigo Serradura
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-01-02 00:00:00.000000000 Z
+date: 2024-02-01 00:00:00.000000000 Z
 dependencies: []
-description: Empower Ruby apps with pragmatic use of Result pattern (monad), Railway
-  Oriented Programming, and B/CDD.
+description: Unleash a pragmatic and observable use of Result Pattern and Railway-Oriented
+  Programming in Ruby.
 email:
 - rodrigo.serradura@gmail.com
 executables: []
@@ -26,8 +26,43 @@ files:
 - README.md
 - Rakefile
 - Steepfile
+- examples/multiple_listeners/Rakefile
+- examples/multiple_listeners/app/models/account.rb
+- examples/multiple_listeners/app/models/account/member.rb
+- examples/multiple_listeners/app/models/account/owner_creation.rb
+- examples/multiple_listeners/app/models/user.rb
+- examples/multiple_listeners/app/models/user/creation.rb
+- examples/multiple_listeners/app/models/user/token.rb
+- examples/multiple_listeners/app/models/user/token/creation.rb
+- examples/multiple_listeners/config.rb
+- examples/multiple_listeners/config/boot.rb
+- examples/multiple_listeners/config/initializers/bcdd.rb
+- examples/multiple_listeners/db/setup.rb
+- examples/multiple_listeners/lib/bcdd/result/rollback_on_failure.rb
+- examples/multiple_listeners/lib/bcdd/result/transitions_record.rb
+- examples/multiple_listeners/lib/runtime_breaker.rb
+- examples/multiple_listeners/lib/transitions_listener/stdout.rb
+- examples/single_listener/Rakefile
+- examples/single_listener/app/models/account.rb
+- examples/single_listener/app/models/account/member.rb
+- examples/single_listener/app/models/account/owner_creation.rb
+- examples/single_listener/app/models/user.rb
+- examples/single_listener/app/models/user/creation.rb
+- examples/single_listener/app/models/user/token.rb
+- examples/single_listener/app/models/user/token/creation.rb
+- examples/single_listener/config.rb
+- examples/single_listener/config/boot.rb
+- examples/single_listener/config/initializers/bcdd.rb
+- examples/single_listener/db/setup.rb
+- examples/single_listener/lib/bcdd/result/rollback_on_failure.rb
+- examples/single_listener/lib/runtime_breaker.rb
+- examples/single_listener/lib/single_transitions_listener.rb
 - lib/bcdd-result.rb
 - lib/bcdd/result.rb
+- lib/bcdd/result/callable_and_then.rb
+- lib/bcdd/result/callable_and_then/caller.rb
+- lib/bcdd/result/callable_and_then/config.rb
+- lib/bcdd/result/callable_and_then/error.rb
 - lib/bcdd/result/config.rb
 - lib/bcdd/result/config/options.rb
 - lib/bcdd/result/config/switcher.rb
@@ -36,6 +71,7 @@ files:
 - lib/bcdd/result/config/switchers/features.rb
 - lib/bcdd/result/config/switchers/pattern_matching.rb
 - lib/bcdd/result/context.rb
+- lib/bcdd/result/context/callable_and_then.rb
 - lib/bcdd/result/context/expectations.rb
 - lib/bcdd/result/context/expectations/mixin.rb
 - lib/bcdd/result/context/failure.rb
@@ -57,16 +93,21 @@ files:
 - lib/bcdd/result/failure/methods.rb
 - lib/bcdd/result/handler.rb
 - lib/bcdd/result/handler/allowed_types.rb
+- lib/bcdd/result/ignored_types.rb
 - lib/bcdd/result/mixin.rb
 - lib/bcdd/result/success.rb
 - lib/bcdd/result/success/methods.rb
 - lib/bcdd/result/transitions.rb
+- lib/bcdd/result/transitions/config.rb
+- lib/bcdd/result/transitions/listener.rb
+- lib/bcdd/result/transitions/listeners.rb
 - lib/bcdd/result/transitions/tracking.rb
 - lib/bcdd/result/transitions/tracking/disabled.rb
 - lib/bcdd/result/transitions/tracking/enabled.rb
 - lib/bcdd/result/transitions/tree.rb
 - lib/bcdd/result/version.rb
 - sig/bcdd/result.rbs
+- sig/bcdd/result/callable_and_then.rbs
 - sig/bcdd/result/config.rbs
 - sig/bcdd/result/context.rbs
 - sig/bcdd/result/contract.rbs
@@ -74,6 +115,7 @@ files:
 - sig/bcdd/result/error.rbs
 - sig/bcdd/result/expectations.rbs
 - sig/bcdd/result/handler.rbs
+- sig/bcdd/result/ignored_types.rbs
 - sig/bcdd/result/mixin.rbs
 - sig/bcdd/result/transitions.rbs
 - sig/bcdd/result/version.rbs
@@ -104,6 +146,6 @@ requirements: []
 rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
-summary: Empower Ruby apps with pragmatic use of Result pattern (monad), Railway Oriented
-  Programming, and B/CDD.
+summary: Unleash a pragmatic and observable use of Result Pattern and Railway-Oriented
+  Programming in Ruby.
 test_files: []