pg_eventstore 1.11.0 → 1.13.0

data/sig/pg_eventstore/subscriptions/basic_runner.rbs

@@ -1,12 +1,25 @@
 module PgEventstore
   class BasicRunner
-    include PgEventstore::Extensions::CallbacksExtension
+    include Extensions::CallbacksExtension
     extend Forwardable
 
-    # _@param_ `run_interval` — seconds. Determines how often to run async task. Async task is determined by :after_runner_stopped callback
-    #
-    # _@param_ `async_shutdown_time` — seconds. Determines how long to wait for the async shutdown to wait for the runner to finish.
-    %a{rbs:test:skip} def initialize: ((Integer | Float) run_interval, (Integer | Float) async_shutdown_time) -> void
+    @async_shutdown_time: Integer | Float
+    @mutex: Thread::Mutex
+    @recovery_strategies: Array[RunnerRecoveryStrategy]
+    @run_interval: Integer | Float
+    @runner: Thread?
+
+    @state: RunnerState
+
+    %a{rbs:test:skip} def initialize: (
+        run_interval: (Integer | Float),
+        async_shutdown_time: (Integer | Float),
+        recovery_strategies: Array[RunnerRecoveryStrategy]
+      ) -> void
+
+    def async_recover: (StandardError error, RunnerRecoveryStrategy strategy, Integer current_runner_id)-> Thread
+
+    def restore: -> untyped
 
     def start: () -> self
 
@@ -14,14 +27,16 @@ module PgEventstore
 
     def stop_async: () -> self
 
-    def restore: () -> self
-
     def wait_for_finish: () -> self
 
     def state: () -> String
 
     # _@param_ `state`
-    def within_state: (Symbol state) { () -> untyped } -> untyped
+    def within_state: (Symbol state) { () -> untyped } -> untyped?
+
+    private
+
+    def suitable_strategy: (StandardError error)-> RunnerRecoveryStrategy?
 
     def synchronize: () { () -> untyped } -> untyped
 
@@ -29,9 +44,10 @@ module PgEventstore
 
     def delegate_change_state_cbx: () -> void
 
-    # _@param_ `state`
     def change_state: (String state) -> void
 
-    def define_callback: () -> void
+    def recoverable: { () -> untyped } -> untyped
+
+    def init_recovery_ripper: (Integer current_runner_id) -> untyped
   end
 end

data/sig/pg_eventstore/subscriptions/callback_handlers/commands_handler_handlers.rbs

@@ -1,10 +1,10 @@
 module PgEventstore
   class CommandsHandlerHandlers
-    def self.process_feeder_commands: (Symbol config_name, PgEventstore::SubscriptionFeeder subscription_feeder) -> void
+    def self.process_feeder_commands: (Symbol config_name, SubscriptionFeeder subscription_feeder) -> void
 
-    def self.process_runners_commands: (Symbol config_name, Array[PgEventstore::SubscriptionRunner] runners,
-        PgEventstore::SubscriptionFeeder subscription_feeder) -> void
-
-    def self.restore_runner: (PgEventstore::BasicRunner basic_runner, Integer restart_delay, StandardError error) -> void
+    def self.process_runners_commands: (
+        Symbol config_name, Array[SubscriptionRunner] runners,
+        SubscriptionFeeder subscription_feeder
+      ) -> void
   end
 end

data/sig/pg_eventstore/subscriptions/callback_handlers/subscription_feeder_handlers.rbs

@@ -1,6 +1,6 @@
 module PgEventstore
   class SubscriptionFeederHandlers
-    include PgEventstore::Extensions::CallbackHandlersExtension
+    include Extensions::CallbackHandlersExtension
 
     def self.update_subscriptions_set_state: (PgEventstore::SubscriptionsSetLifecycle subscriptions_set_lifecycle, String state) -> void
 
@@ -12,8 +12,6 @@ module PgEventstore
 
     def self.persist_error_info: (PgEventstore::SubscriptionsSetLifecycle subscriptions_set_lifecycle, StandardError error) -> void
 
-    def self.restart_runner: (PgEventstore::SubscriptionsSetLifecycle subscriptions_set_lifecycle, PgEventstore::BasicRunner basic_runner, StandardError _error) -> void
-
     def self.ping_subscriptions_set: (PgEventstore::SubscriptionsSetLifecycle subscriptions_set_lifecycle) -> void
 
     def self.feed_runners: (PgEventstore::SubscriptionsLifecycle subscriptions_lifecycle, Symbol config_name) -> void

data/sig/pg_eventstore/subscriptions/callback_handlers/subscription_runner_handlers.rbs

@@ -6,10 +6,6 @@ module PgEventstore
 
     def self.update_subscription_error: (PgEventstore::Subscription subscription, PgEventstore::WrappedException error) -> void
 
-    def self.restart_events_processor: (PgEventstore::Subscription subscription, _RestartTerminator? restart_terminator,
-        _FailedSubscriptionNotifier? failed_subscription_notifier, PgEventstore::EventsProcessor events_processor,
-        PgEventstore::WrappedException error) -> void
-
     def self.update_subscription_chunk_stats: (PgEventstore::Subscription subscription, Integer global_position) -> void
 
     def self.update_subscription_restarts: (PgEventstore::Subscription subscription) -> void

data/sig/pg_eventstore/subscriptions/commands_handler.rbs

@@ -1,25 +1,22 @@
 module PgEventstore
   class CommandsHandler
     extend Forwardable
-    RESTART_DELAY: Integer
+
     PULL_INTERVAL: Integer
 
+    @basic_runner: BasicRunner
+    @config_name: Symbol
+
+    @runners: ::Array[SubscriptionRunner]
+    @subscription_feeder: SubscriptionFeeder
+
     # _@param_ `config_name`
     #
     # _@param_ `subscription_feeder`
     #
     # _@param_ `runners`
-    def initialize: (Symbol config_name, PgEventstore::SubscriptionFeeder subscription_feeder, ::Array[PgEventstore::SubscriptionRunner] runners) -> void
+    def initialize: (Symbol config_name, SubscriptionFeeder subscription_feeder, ::Array[SubscriptionRunner] runners) -> void
 
     def attach_runner_callbacks: () -> untyped
-
-    def process_async: () -> untyped
-
-    # _@param_ `error`
-    def after_runner_died: (StandardError error) -> void
-
-    def subscription_feeder_commands: () -> PgEventstore::CommandHandlers::SubscriptionFeederCommands
-
-    def subscription_runners_commands: () -> PgEventstore::CommandHandlers::SubscriptionRunnersCommands
   end
 end

data/sig/pg_eventstore/subscriptions/events_processor.rbs

@@ -3,32 +3,20 @@ module PgEventstore
     include PgEventstore::Extensions::CallbacksExtension
     extend Forwardable
 
-    # _@param_ `handler`
-    %a{rbs:test:skip} def initialize: (_RawEventHandler handler, graceful_shutdown_timeout: Float | Integer) -> void
+    %a{rbs:test:skip} def initialize: (
+        _RawEventHandler handler,
+        graceful_shutdown_timeout: Float | Integer,
+        ?recovery_strategies: Array[RunnerRecoveryStrategy]
+      ) -> void
 
-    # _@param_ `raw_events`
     def feed: (::Array[::Hash[untyped, untyped]] raw_events) -> void
 
     def events_left_in_chunk: () -> Integer
 
     def clear_chunk: () -> void
 
-    # _@param_ `raw_event`
     def process_event: (::Hash[untyped, untyped] raw_event) -> void
 
     def attach_runner_callbacks: () -> void
-
-    def process_async: () -> void
-
-    def after_runner_died: (StandardError error) -> void
-
-    def before_runner_restored: () -> void
-
-    def change_state: (*untyped args, **untyped kwargs) -> void
-
-    # _@param_ `raw_event`
-    def global_position: (::Hash[untyped, untyped] raw_event) -> Integer
-
-    def define_callback: () -> void
   end
 end

data/sig/pg_eventstore/subscriptions/runner_recovery_strategies/restore_connection.rbs

@@ -0,0 +1,18 @@
+module PgEventstore
+  module RunnerRecoveryStrategies
+    class RestoreConnection
+      include RunnerRecoveryStrategy
+
+      EXCEPTIONS_TO_HANDLE: Array[StandardError]
+      TIME_BETWEEN_RETRIES: Integer
+
+      @config_name: Symbol
+
+      def initialize: (Symbol config_name)-> untyped
+
+      private
+
+      def connection: -> Connection
+    end
+  end
+end

data/sig/pg_eventstore/subscriptions/runner_recovery_strategies/restore_subscription_feeder.rbs

@@ -0,0 +1,11 @@
+module PgEventstore
+  module RunnerRecoveryStrategies
+    class RestoreSubscriptionFeeder
+      include RunnerRecoveryStrategy
+
+      @subscriptions_set_lifecycle: SubscriptionsSetLifecycle
+
+      def initialize: (subscriptions_set_lifecycle: SubscriptionsSetLifecycle)-> untyped
+    end
+  end
+end

data/sig/pg_eventstore/subscriptions/runner_recovery_strategies/restore_subscription_runner.rbs

@@ -0,0 +1,17 @@
+module PgEventstore
+  module RunnerRecoveryStrategies
+    class RestoreSubscriptionRunner
+      include RunnerRecoveryStrategy
+
+      @failed_subscription_notifier: _FailedSubscriptionNotifier?
+      @restart_terminator: _RestartTerminator?
+      @subscription: Subscription
+
+      def initialize: (
+          subscription: Subscription,
+          restart_terminator: _RestartTerminator?,
+          failed_subscription_notifier: _FailedSubscriptionNotifier?
+        )-> untyped
+    end
+  end
+end

data/sig/pg_eventstore/subscriptions/runner_recovery_strategy.rbs

@@ -0,0 +1,7 @@
+module PgEventstore
+  module RunnerRecoveryStrategy
+    def recover: (StandardError error)-> bool
+
+    def recovers?: (StandardError error)-> bool
+  end
+end

data/sig/pg_eventstore/subscriptions/subscription_feeder.rbs

@@ -17,19 +17,17 @@ module PgEventstore
 
     def id: () -> Integer?
 
-    # _@param_ `runner`
-    def add: (PgEventstore::SubscriptionRunner runner) -> PgEventstore::SubscriptionRunner
-
     def start_all: () -> void
 
     def stop_all: () -> void
 
-    def read_only_subscriptions: () -> ::Array[PgEventstore::Subscription]
-
-    def read_only_subscriptions_set: () -> PgEventstore::SubscriptionsSet?
-
     def attach_runner_callbacks: () -> void
 
-    def assert_proper_state!: () -> void
+    private
+
+    def recovery_strategies: (
+        Symbol config_name,
+        SubscriptionsSetLifecycle subscriptions_set_lifecycle
+      ) -> Array[RunnerRecoveryStrategy]
   end
 end

data/sig/pg_eventstore/subscriptions/subscription_runner.rbs

@@ -5,19 +5,13 @@ module PgEventstore
     MIN_EVENTS_PER_CHUNK: Integer
     INITIAL_EVENTS_PER_CHUNK: Integer
 
-    # _@param_ `stats`
-    #
-    # _@param_ `events_processor`
-    #
-    # _@param_ `subscription`
-    #
-    # _@param_ `restart_terminator`
-    #
-    # _@param_ `failed_subscription_notifier`
+    # Returns the value of attribute subscription.
+    attr_reader subscription: Subscription
+
     def initialize: (
-        stats: PgEventstore::SubscriptionHandlerPerformance,
-        events_processor: PgEventstore::EventsProcessor,
-        subscription: PgEventstore::Subscription,
+        stats: SubscriptionHandlerPerformance,
+        events_processor: EventsProcessor,
+        subscription: Subscription,
         ?restart_terminator: _RestartTerminator?,
         ?failed_subscription_notifier: _FailedSubscriptionNotifier?
       ) -> void
@@ -31,28 +25,5 @@ module PgEventstore
     def estimate_events_number: () -> Integer
 
     def attach_callbacks: () -> void
-
-    # _@param_ `action`
-    def track_exec_time: (Proc action, *untyped args) -> void
-
-    # _@param_ `current_position`
-    def update_subscription_stats: (Integer current_position) -> void
-
-    # _@param_ `state`
-    def update_subscription_state: (String state) -> void
-
-    def update_subscription_restarts: () -> void
-
-    # _@param_ `error`
-    def update_subscription_error: (StandardError error) -> void
-
-    # _@param_ `global_position`
-    def update_subscription_chunk_stats: (Integer global_position) -> void
-
-    # _@param_ `_error`
-    def restart_subscription: (StandardError error) -> void
-
-    # Returns the value of attribute subscription.
-    attr_accessor subscription: PgEventstore::Subscription
   end
 end

data/sig/pg_eventstore/subscriptions/subscriptions_manager.rbs

@@ -74,5 +74,13 @@ module PgEventstore
 
     # Returns the value of attribute config.
     attr_accessor config: PgEventstore::Config
+
+    private
+
+    def recovery_strategies: (
+        Subscription subscription,
+        _RestartTerminator? restart_terminator,
+        _FailedSubscriptionNotifier? failed_subscription_notifier
+      ) -> Array[RunnerRecoveryStrategy]
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pg_eventstore
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Ivan Dzyzenko
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
@@ -116,6 +115,7 @@ files:
 - lib/pg_eventstore/cli/wait_for_subscriptions_set_shutdown.rb
 - lib/pg_eventstore/client.rb
 - lib/pg_eventstore/commands.rb
+- lib/pg_eventstore/commands/all_stream_read_grouped.rb
 - lib/pg_eventstore/commands/append.rb
 - lib/pg_eventstore/commands/delete_event.rb
 - lib/pg_eventstore/commands/delete_stream.rb
@@ -124,6 +124,7 @@ files:
 - lib/pg_eventstore/commands/link_to.rb
 - lib/pg_eventstore/commands/multiple.rb
 - lib/pg_eventstore/commands/read.rb
+- lib/pg_eventstore/commands/regular_stream_read_grouped.rb
 - lib/pg_eventstore/commands/regular_stream_read_paginated.rb
 - lib/pg_eventstore/commands/system_stream_read_paginated.rb
 - lib/pg_eventstore/config.rb
@@ -139,6 +140,7 @@ files:
 - lib/pg_eventstore/extensions/using_connection_extension.rb
 - lib/pg_eventstore/maintenance.rb
 - lib/pg_eventstore/middleware.rb
+- lib/pg_eventstore/partition.rb
 - lib/pg_eventstore/pg_connection.rb
 - lib/pg_eventstore/queries.rb
 - lib/pg_eventstore/queries/event_queries.rb
@@ -146,7 +148,9 @@ files:
 - lib/pg_eventstore/queries/maintenance_queries.rb
 - lib/pg_eventstore/queries/partition_queries.rb
 - lib/pg_eventstore/queries/transaction_queries.rb
+- lib/pg_eventstore/query_builders/basic_filtering.rb
 - lib/pg_eventstore/query_builders/events_filtering.rb
+- lib/pg_eventstore/query_builders/partitions_filtering.rb
 - lib/pg_eventstore/rspec/has_option_matcher.rb
 - lib/pg_eventstore/rspec/test_helpers.rb
 - lib/pg_eventstore/sql_builder.rb
@@ -166,6 +170,11 @@ files:
 - lib/pg_eventstore/subscriptions/queries/subscription_queries.rb
 - lib/pg_eventstore/subscriptions/queries/subscriptions_set_command_queries.rb
 - lib/pg_eventstore/subscriptions/queries/subscriptions_set_queries.rb
+- lib/pg_eventstore/subscriptions/runner_recovery_strategies.rb
+- lib/pg_eventstore/subscriptions/runner_recovery_strategies/restore_connection.rb
+- lib/pg_eventstore/subscriptions/runner_recovery_strategies/restore_subscription_feeder.rb
+- lib/pg_eventstore/subscriptions/runner_recovery_strategies/restore_subscription_runner.rb
+- lib/pg_eventstore/subscriptions/runner_recovery_strategy.rb
 - lib/pg_eventstore/subscriptions/runner_state.rb
 - lib/pg_eventstore/subscriptions/subscription.rb
 - lib/pg_eventstore/subscriptions/subscription_feeder.rb
@@ -271,6 +280,7 @@ files:
 - sig/pg_eventstore/cli/try_unlock_subscriptions_set.rbs
 - sig/pg_eventstore/cli/wait_for_subscriptions_set_shutdown.rbs
 - sig/pg_eventstore/client.rbs
+- sig/pg_eventstore/commands/all_stream_read_grouped.rbs
 - sig/pg_eventstore/commands/append.rbs
 - sig/pg_eventstore/commands/delete_event.rbs
 - sig/pg_eventstore/commands/delete_stream.rbs
@@ -279,6 +289,7 @@ files:
 - sig/pg_eventstore/commands/link_to.rbs
 - sig/pg_eventstore/commands/multiple.rbs
 - sig/pg_eventstore/commands/read.rbs
+- sig/pg_eventstore/commands/regular_stream_read_grouped.rbs
 - sig/pg_eventstore/commands/regular_stream_read_paginated.rbs
 - sig/pg_eventstore/commands/system_stream_read_paginated.rbs
 - sig/pg_eventstore/config.rbs
@@ -294,6 +305,7 @@ files:
 - sig/pg_eventstore/extensions/using_connection_extension.rbs
 - sig/pg_eventstore/maintenance.rbs
 - sig/pg_eventstore/middleware.rbs
+- sig/pg_eventstore/partition.rbs
 - sig/pg_eventstore/pg_connection.rbs
 - sig/pg_eventstore/queries.rbs
 - sig/pg_eventstore/queries/event_queries.rbs
@@ -301,7 +313,9 @@ files:
 - sig/pg_eventstore/queries/maintenance_queries.rbs
 - sig/pg_eventstore/queries/partition_queries.rbs
 - sig/pg_eventstore/queries/transaction_queries.rbs
+- sig/pg_eventstore/query_builders/basic_filtering.rbs
 - sig/pg_eventstore/query_builders/events_filtering_query.rbs
+- sig/pg_eventstore/query_builders/partitions_filtering.rbs
 - sig/pg_eventstore/sql_builder.rbs
 - sig/pg_eventstore/stream.rbs
 - sig/pg_eventstore/subscriptions/basic_runner.rbs
@@ -319,6 +333,10 @@ files:
 - sig/pg_eventstore/subscriptions/queries/subscription_queries.rbs
 - sig/pg_eventstore/subscriptions/queries/subscriptions_set_command_queries.rbs
 - sig/pg_eventstore/subscriptions/queries/subscriptions_set_queries.rbs
+- sig/pg_eventstore/subscriptions/runner_recovery_strategies/restore_connection.rbs
+- sig/pg_eventstore/subscriptions/runner_recovery_strategies/restore_subscription_feeder.rbs
+- sig/pg_eventstore/subscriptions/runner_recovery_strategies/restore_subscription_runner.rbs
+- sig/pg_eventstore/subscriptions/runner_recovery_strategy.rbs
 - sig/pg_eventstore/subscriptions/runner_state.rbs
 - sig/pg_eventstore/subscriptions/subscription.rbs
 - sig/pg_eventstore/subscriptions/subscription_feeder.rbs
@@ -368,7 +386,6 @@ metadata:
   homepage_uri: https://github.com/yousty/pg_eventstore
   source_code_uri: https://github.com/yousty/pg_eventstore
   changelog_uri: https://github.com/yousty/pg_eventstore/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -383,8 +400,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: EventStore implementation using PostgreSQL
 test_files: []