pg_eventstore 1.13.4 → 3.0.0

data/sig/pg_eventstore/errors.rbs

@@ -5,28 +5,31 @@ module PgEventstore
     def to_h: () -> ::Hash[untyped, untyped]
   end
 
-  class StreamNotFoundError < PgEventstore::Error
+  class StreamNotFoundError < Error
     # _@param_ `stream`
-    def initialize: (PgEventstore::Stream stream) -> void
+    def initialize: (Stream stream) -> void
 
     # Returns the value of attribute stream.
-    attr_accessor stream: PgEventstore::Stream
+    attr_accessor stream: Stream
   end
 
-  class SystemStreamError < PgEventstore::Error
+  class SystemStreamError < Error
     # _@param_ `stream`
-    def initialize: (PgEventstore::Stream stream) -> void
+    def initialize: (Stream stream) -> void
 
-    attr_accessor stream: PgEventstore::Stream
+    attr_accessor stream: Stream
   end
 
-  class WrongExpectedRevisionError < PgEventstore::Error
-    # _@param_ `revision`
-    #
-    # _@param_ `expected_revision`
-    #
-    # _@param_ `stream`
-    def initialize: (revision: Integer, expected_revision: (Integer | Symbol), stream: PgEventstore::Stream) -> void
+  class WrongExpectedRevisionError < Error
+
+    attr_accessor stream: Stream
+    attr_accessor revision: Integer
+    attr_accessor expected_revision: (Integer | Symbol)
+    attr_accessor verdict: Symbol
+
+    def initialize: (revision: Integer, expected_revision: (Integer | Symbol), stream: Stream, verdict: Symbol) -> void
+
+    private
 
     def user_friendly_message: () -> String
 
@@ -39,28 +42,52 @@ module PgEventstore
     def unmatched_stream_revision: () -> String
 
     def stream_descr: () -> String
+  end
 
-    attr_accessor stream: PgEventstore::Stream
+  class WrongExpectedTypesRevisionError < Error
+    class Verdict
+      include Extensions::OptionsExtension
+      include Extensions::OptionsDefaults
 
-    attr_accessor revision: Integer
+      attr_accessor verdict: Symbol
+      attr_accessor event_type: String | Symbol
+      attr_accessor current_revision: Integer
+      attr_accessor expected_revision: Integer | Symbol
+      attr_accessor expected_markers: Array[String]?
+    end
 
-    attr_accessor expected_revision: (Integer | Symbol)
-  end
+    attr_accessor stream: Stream
+    attr_accessor verdicts: Array[Verdict]
 
-  class RecordNotFound < PgEventstore::Error
-    # _@param_ `table_name`
-    #
-    # _@param_ `id`
-    def initialize: (String table_name, (Integer | String) id) -> void
+    def initialize: (stream: Stream, verdicts: Array[Verdict]) -> void
 
-    def user_friendly_message: () -> String
+    private
 
+    def event_descr: (Verdict verdict) -> String
+
+    def event_is_absent: (Verdict verdict) -> String
+
+    def event_is_present: (Verdict verdict) -> String
+
+    def event_revision_does_not_match: (Verdict verdict) -> String
+
+    def revision_descr: (Verdict verdict) -> String
+
+    def stream_descr: -> String
+
+    def user_friendly_message: -> String
+  end
+
+  class RecordNotFound < Error
     attr_accessor table_name: String
+    attr_accessor id: untyped
+
+    def initialize: (String table_name, untyped id) -> void
 
-    attr_accessor id: (Integer | String)
+    def user_friendly_message: () -> String
   end
 
-  class SubscriptionAlreadyLockedError < PgEventstore::Error
+  class SubscriptionAlreadyLockedError < Error
     # _@param_ `set` — subscriptions set name
     #
     # _@param_ `name` — subscription's name
@@ -77,7 +104,7 @@ module PgEventstore
     attr_accessor lock_id: Integer
   end
 
-  class WrongLockIdError < PgEventstore::Error
+  class WrongLockIdError < Error
     # _@param_ `set` — subscriptions set name
     #
     # _@param_ `name` — subscription's name
@@ -94,7 +121,7 @@ module PgEventstore
     attr_accessor lock_id: Integer
   end
 
-  class NotPersistedEventError < PgEventstore::Error
+  class NotPersistedEventError < Error
     # _@param_ `event`
     def initialize: (PgEventstore::Event event) -> void
 
@@ -103,32 +130,35 @@ module PgEventstore
     attr_accessor event: PgEventstore::Event
   end
 
-  class MissingPartitions < PgEventstore::Error
+  class MissingPartitions < Error
     # _@param_ `stream`
     #
     # _@param_ `event_types`
-    def initialize: (PgEventstore::Stream stream, ::Array[String] event_types) -> void
+    def initialize: (Stream stream, ::Array[String] event_types) -> void
 
-    attr_accessor stream: PgEventstore::Stream
+    attr_accessor stream: Stream
 
     attr_accessor event_types: ::Array[String]
   end
 
-  class TooManyRecordsToLockError < PgEventstore::Error
-    def initialize: (PgEventstore::Stream stream, Integer number_of_records) -> void
+  class TooManyRecordsToLockError < Error
+    def initialize: (Stream stream, Integer number_of_records) -> void
 
-    attr_accessor stream: PgEventstore::Stream
+    attr_accessor stream: Stream
 
     attr_accessor number_of_records: Integer
 
     def user_friendly_message: -> String
   end
 
-  class WrappedException < PgEventstore::Error
+  class WrappedException < Error
     def initialize: (StandardError original_exception, Hash[Symbol, untyped] extra) -> void
 
     attr_accessor original_exception: StandardError
 
     attr_accessor extra: Hash[Symbol, untyped]
   end
+
+  class NotSupportedError < Error
+  end
 end

data/sig/pg_eventstore/event.rbs

@@ -1,11 +1,15 @@
 module PgEventstore
   class Event
-    include Extensions::OptionsExtension
-
+    MARKERS_METADATA_KEY: String
+    NON_EXISTING_EVENT_REVISION: Integer
     LINK_TYPE: String
     PRIMARY_TABLE_NAME: String
+    SYSTEM_KEY_PREFIX: String
+    SYSTEM_SYMBOL: String
 
-    def ==: ((Object | PgEventstore::Event) other) -> bool
+    include Extensions::OptionsExtension
+
+    def ==: ((Object | Event) other) -> bool
 
     def link?: () -> bool
 
@@ -29,20 +33,30 @@ module PgEventstore
 
     attr_accessor global_position: Integer?
 
-    attr_accessor stream: PgEventstore::Stream?
+    attr_accessor stream: Stream?
 
     attr_accessor stream_revision: Integer?
 
     attr_accessor data: ::Hash[untyped, untyped]
 
+    attr_accessor markers: ::Array[String]
+
+    attr_accessor feature_markers: ::Array[FeatureMarker]
+
     attr_accessor metadata: ::Hash[untyped, untyped]
 
-    attr_accessor link_id: String?
+    attr_accessor link_global_position: Integer?
 
     attr_accessor link_partition_id: Integer?
 
-    attr_accessor link: PgEventstore::Event?
+    attr_accessor link: Event?
 
     attr_accessor created_at: Time?
+
+    attr_accessor caused_by: Event?
+
+    attr_accessor correlation_id: String?
+
+    attr_accessor causation_id: String?
   end
 end

data/sig/pg_eventstore/event_deserializer.rbs

@@ -1,19 +1,14 @@
 module PgEventstore
   class EventDeserializer
-    # _@param_ `middlewares`
-    #
-    # _@param_ `event_class_resolver`
-    def initialize: (::Array[PgEventstore::Middleware] middlewares, _EventClassResolver event_class_resolver) -> void
+    def initialize: (::Array[Middleware] middlewares, _EventClassResolver event_class_resolver) -> void
 
-    # _@param_ `raw_events`
-    def deserialize_many: (::Array[::Hash[untyped, untyped]] raw_events) -> ::Array[PgEventstore::Event]
+    def deserialize_many: (::Array[::Hash[untyped, untyped]] | Enumerator[Hash[untyped, untyped]] raw_events) -> ::Array[Event]
 
-    # _@param_ `attrs`
-    def deserialize: (::Hash[untyped, untyped] attrs) -> PgEventstore::Event
+    def deserialize: (::Hash[untyped, untyped] attrs) -> Event
 
-    def without_middlewares: () -> PgEventstore::EventDeserializer
+    def without_middlewares: () -> EventDeserializer
 
-    attr_accessor middlewares: ::Array[PgEventstore::Middleware]
+    attr_accessor middlewares: ::Array[Middleware]
 
     attr_accessor event_class_resolver: _EventClassResolver
   end

data/sig/pg_eventstore/event_global_index.rbs

@@ -0,0 +1,60 @@
+module PgEventstore
+  class EventGlobalIndex
+    include Extensions::OptionsExtension
+    include Extensions::OptionsDefaults
+
+    def self.create_representation: (Hash[untyped, untyped] attributes,
+        repr: Symbol?) -> (EventGlobalIndex | SubscriptionRepr | ReadApiRepr | WriteApiRepr | RevisionCheckRepr)
+
+    attr_accessor global_position: Integer
+    attr_accessor subscription_position: Integer?
+    attr_accessor stream_revision: Integer
+    attr_accessor context_partition_id: Integer
+    attr_accessor stream_name_partition_id: Integer
+    attr_accessor event_type_partition_id: Integer
+    attr_accessor streams_global_index_id: Integer
+
+    module ReprType
+      REVISION_CHECK: Symbol
+      SUBSCRIPTION: Symbol
+      READ_API: Symbol
+      WRITE_API: Symbol
+    end
+
+    class SubscriptionRepr
+      include Extensions::OptionsExtension
+      include Extensions::OptionsDefaults
+
+      attr_accessor global_position: Integer
+      attr_accessor subscription_position: Integer
+      attr_accessor event_type_partition_id: Integer
+
+      def to_subscription_position_attrs: -> { global_position: Integer, subscription_position: Integer }
+    end
+
+    class ReadApiRepr
+      include Extensions::OptionsExtension
+      include Extensions::OptionsDefaults
+
+      attr_accessor global_position: Integer
+      attr_accessor event_type_partition_id: Integer
+    end
+
+    class WriteApiRepr
+      include Extensions::OptionsExtension
+      include Extensions::OptionsDefaults
+
+      attr_accessor global_position: Integer
+      attr_accessor event_type_partition_id: Integer
+      attr_accessor stream_revision: Integer
+    end
+
+    class RevisionCheckRepr
+      include Extensions::OptionsExtension
+      include Extensions::OptionsDefaults
+
+      attr_accessor sequence_number: Integer
+      attr_accessor stream_revision: Integer
+    end
+  end
+end

data/sig/pg_eventstore/event_marker.rbs

@@ -0,0 +1,9 @@
+module PgEventstore
+  class EventMarker
+    include Extensions::OptionsExtension
+    include Extensions::OptionsDefaults
+
+    attr_accessor id: Integer
+    attr_accessor name: String
+  end
+end

data/sig/pg_eventstore/event_marker_index.rbs

@@ -0,0 +1,12 @@
+module PgEventstore
+  class EventMarkerIndex
+    include Extensions::OptionsExtension
+    include Extensions::OptionsDefaults
+
+    attr_accessor marker_id: Integer
+    attr_accessor streams_global_index_id: Integer
+    attr_accessor event_type_partition_id: Integer
+    attr_accessor global_position: Integer
+    attr_accessor stream_revision: Integer
+  end
+end

data/sig/pg_eventstore/extensions/acts_as_configurable.rbs

@@ -0,0 +1,29 @@
+module PgEventstore
+  module Extensions
+    module ActsAsConfigurable
+      def acts_as_configurable: (?default_config: Symbol, config_class: Class) -> void
+
+      module Configurable
+        @config: Hash[Symbol, Extensions::OptionsExtension]
+
+        @connection: Hash[Symbol, Connection]
+
+        attr_reader mutex: Thread::Mutex
+
+        def configure: (?name: Symbol) { (BasicConfig) -> untyped } -> untyped
+
+        def config: (?Symbol name) -> BasicConfig
+
+        def available_configs: () -> ::Array[Symbol]
+
+        def connection: (?Symbol name) -> Connection
+
+        private
+
+        def connection_options: (BasicConfig config) -> Hash[untyped, untyped]
+
+        def init_variables: -> void
+      end
+    end
+  end
+end

data/sig/pg_eventstore/extensions/options_defaults.rbs

@@ -0,0 +1,7 @@
+module PgEventstore
+  module Extensions
+    module OptionsDefaults
+      def ==: (untyped) -> bool
+    end
+  end
+end

data/sig/pg_eventstore/extensions/options_extension.rbs

@@ -15,7 +15,15 @@ module PgEventstore
       end
 
       class Options
-        def []: (Symbol option) -> PgEventstore::Extensions::OptionsExtension::Option?
+        attr_reader options: Hash[Extensions::OptionsExtension::Option, true]
+
+        def initialize: (?Array[Extensions::OptionsExtension::Option] options) -> void
+
+        def +: (Options other) -> Options
+
+        def []: (Symbol option_name) -> Extensions::OptionsExtension::Option?
+
+        def include?: (Extensions::OptionsExtension::Option option) -> bool
       end
 
       def self.included: (untyped klass) -> untyped

data/sig/pg_eventstore/feature_marker.rbs

@@ -0,0 +1,10 @@
+module PgEventstore
+  class FeatureMarker
+    include Extensions::OptionsExtension
+    include Extensions::OptionsDefaults
+
+    attr_accessor marker: String
+    attr_accessor description: String?
+    attr_accessor purpose: Symbol?
+  end
+end

data/sig/pg_eventstore/maintenance.rbs

@@ -1,19 +1,23 @@
 module PgEventstore
   class Maintenance
-    @config: PgEventstore::Config
+    @config: Config
 
-    attr_reader config: PgEventstore::Config
+    attr_reader config: Config
 
-    def initialize: (PgEventstore::Config config) -> void
+    def initialize: (Config config) -> void
 
-    def connection: () -> PgEventstore::Connection
+    def connection: () -> Connection
 
-    def delete_event: (PgEventstore::Event event, ?force: bool)-> bool
+    def delete_event: (Event event, ?force: bool)-> bool
 
-    def delete_stream: (PgEventstore::Stream stream)-> bool
+    def delete_stream: (Stream stream)-> bool
 
-    def maintenance_queries: () -> PgEventstore::MaintenanceQueries
+    def maintenance_queries: () -> MaintenanceQueries
 
-    def transaction_queries: () -> PgEventstore::TransactionQueries
+    def transaction_queries: () -> TransactionQueries
+
+    private
+
+    def events_global_index_queries: -> EventsGlobalIndexQueries
   end
 end

data/sig/pg_eventstore/middleware/event_trace.rbs

@@ -0,0 +1,14 @@
+module PgEventstore
+  module Middleware
+    class EventTracing
+      include Middleware
+
+      CAUSATION_ID_KEY: String
+      CORRELATION_ID_KEY: String
+
+      def self.causation_marker: (String marker) -> FeatureMarker
+
+      def self.correlation_marker: (String marker) -> FeatureMarker
+    end
+  end
+end

data/sig/pg_eventstore/partition.rbs

@@ -3,13 +3,11 @@ module PgEventstore
     include Extensions::OptionsExtension
 
     attr_accessor id: Integer
-
     attr_accessor context: String
-
     attr_accessor stream_name: String?
-
     attr_accessor event_type: String?
-
     attr_accessor table_name: String
+    attr_accessor parent_context_partition_id: Integer?
+    attr_accessor parent_stream_name_partition_id: Integer?
   end
 end

data/sig/pg_eventstore/pg_connection.rbs

@@ -1,9 +1,17 @@
 module PgEventstore
   class PgConnection < PG::Connection
+    PLACEHOLDER_RE: untyped
+
     def exec: (untyped sql) -> untyped
 
     def exec_params: (untyped sql, untyped params) -> untyped
 
+    def compile: (String sql, Array[untyped] params) -> String
+
+    def prepared_value: (untyped value) -> String
+
+    private
+
     def log: (untyped sql, untyped params) -> untyped
 
     def encode_value: (untyped value) -> untyped

data/sig/pg_eventstore/queries/event_marker_queries.rbs

@@ -0,0 +1,21 @@
+module PgEventstore
+  class EventMarkerQueries
+    @query_strategy: QueryStrategy
+
+    attr_reader connection: Connection
+
+    def initialize: (Connection connection, QueryStrategy query_strategy) -> void
+
+    def create_indexes: (
+        Integer stream_idx_id,
+        Array[EventGlobalIndex::WriteApiRepr] write_api_events_index,
+        Hash[Integer, Set[Integer]] revision_to_marker_ids_map
+      ) -> void
+
+    def find_or_create_by: (Array[String] names) -> Array[EventMarker]
+
+    private
+
+    def deserialize: (PG::Result pg_result) -> Array[EventMarker]
+  end
+end

data/sig/pg_eventstore/queries/event_queries.rbs

@@ -1,47 +1,15 @@
 module PgEventstore
   class EventQueries
-    # _@param_ `connection`
-    #
-    # _@param_ `serializer`
-    #
-    # _@param_ `deserializer`
-    def initialize: (PgEventstore::Connection connection, PgEventstore::EventSerializer serializer, PgEventstore::EventDeserializer deserializer) -> void
+    attr_accessor connection: Connection
 
-    # _@param_ `event`
-    def event_exists?: (PgEventstore::Event event) -> bool
+    def initialize: (Connection connection) -> void
 
-    def grouped_events: (Stream stream, Array[Hash[untyped, untyped]] options_by_event_type, **untyped options)-> Array[Event]
+    def insert: (Stream stream, ::Array[Event] events) -> ::Array[Hash[String, untyped]]
 
-    # _@param_ `events`
-    def ids_from_db: (::Array[PgEventstore::Event] events) -> ::Array[String]
+    private
 
-    # _@param_ `stream`
-    def stream_revision: (PgEventstore::Stream stream) -> Integer?
+    def prepared_statements: (Stream stream, ::Array[Event] events) -> ::Array[(::Array[String] | ::Array[Object])]
 
-    # _@param_ `stream`
-    #
-    # _@param_ `options`
-    def stream_events: (PgEventstore::Stream stream, ::Hash[untyped, untyped] options) -> ::Array[PgEventstore::Event]
-
-    # _@param_ `stream`
-    #
-    # _@param_ `events`
-    def insert: (PgEventstore::Stream stream, ::Array[PgEventstore::Event] events) -> ::Array[PgEventstore::Event]
-
-    # _@param_ `stream`
-    #
-    # _@param_ `events`
-    def prepared_statements: (PgEventstore::Stream stream, ::Array[PgEventstore::Event] events) -> ::Array[(::Array[String] | ::Array[Object])]
-
-    def links_resolver: () -> PgEventstore::LinksResolver
-
-    # Returns the value of attribute connection.
-    attr_accessor connection: PgEventstore::Connection
-
-    # Returns the value of attribute serializer.
-    attr_accessor serializer: PgEventstore::EventSerializer
-
-    # Returns the value of attribute deserializer.
-    attr_accessor deserializer: PgEventstore::EventDeserializer
+    def links_resolver: () -> LinksResolver
   end
 end

data/sig/pg_eventstore/queries/events_global_index_queries.rbs

@@ -0,0 +1,37 @@
+module PgEventstore
+  class EventsGlobalIndexQueries
+    @query_strategy: QueryStrategy
+
+    attr_reader connection: Connection
+
+    def initialize: (Connection connection, QueryStrategy query_strategy) -> void
+
+    def fetch_indexes_for_subscriptions: (Hash[Integer, Hash[Symbol, untyped]] grouped_opts) ->
+      Hash[Integer, Array[EventGlobalIndex::SubscriptionRepr]]
+
+    def global_positions_from_db: (Array[Event] events) -> Array[Integer]
+
+    def index_events: (Array[Hash[String, untyped]] raw_events, Array[Partition] affected_partitions,
+        Integer stream_index_id) -> Array[EventGlobalIndex::WriteApiRepr]
+
+    def max_global_position: -> Integer?
+
+    def resolve_indexes: (Array[EventGlobalIndex::ReadApiRepr] | Array[EventGlobalIndex::SubscriptionRepr] indexes,
+        ?direction: (String | Symbol)?, resolve_link_tos: bool) -> Array[Hash[String, untyped]]
+
+    private
+
+    def deserialize: (PG::Result pg_result, ?repr: Symbol?) ->
+      (
+        Array[EventGlobalIndex] |
+        Array[EventGlobalIndex::ReadApiRepr] |
+        Array[EventGlobalIndex::SubscriptionRepr] |
+          Array[EventGlobalIndex::WriteApiRepr] |
+          Array[EventGlobalIndex::RevisionCheckRepr]
+      )
+
+    def links_resolver: -> LinksResolver
+
+    def partition_queries: -> PartitionQueries
+  end
+end

data/sig/pg_eventstore/queries/index_filtering_queries.rbs

@@ -0,0 +1,50 @@
+module PgEventstore
+  class IndexFilteringQueries
+    @query_strategy: QueryStrategy
+
+    attr_reader connection: Connection
+
+    def initialize: (Connection connection, QueryStrategy query_strategy) -> void
+
+    def compute_read_api_chunks_repo: (
+        Array[EventGlobalIndex::ReadApiRepr] indexes,
+        bool resolve_link_tos
+      ) -> Chunks::Repository
+
+    def fetch_grouped_indexes_for_read_api: (
+        QueryBuilders::Filters::Collection filters_collection,
+        QueryBuilders::ReadCursor::StreamCursor cursor
+      ) -> Array[EventGlobalIndex::ReadApiRepr]
+
+    def fetch_indexes_for_read_api: (
+        QueryBuilders::Filters::Collection filters_collection,
+        QueryBuilders::ReadCursor::StreamCursor cursor
+      ) -> Array[EventGlobalIndex::ReadApiRepr]
+
+    def fetch_indexes_for_revision_validation: (
+        Stream stream,
+        Array[
+          Commands::RevisionCheck::ExpectedRevision::EventTypeRevision |
+          Commands::RevisionCheck::ExpectedRevision::EventTypeRevisionWithMarkers |
+          Commands::RevisionCheck::ExpectedRevision::MarkersRevision
+        ] expected_revisions
+      ) -> Array[EventGlobalIndex::RevisionCheckRepr]
+
+    private
+
+    def deserialize: (PG::Result pg_result, ?repr: Symbol?) ->
+      (
+        Array[EventGlobalIndex] |
+        Array[EventGlobalIndex::ReadApiRepr] |
+        Array[EventGlobalIndex::SubscriptionRepr] |
+        Array[EventGlobalIndex::WriteApiRepr] |
+        Array[EventGlobalIndex::RevisionCheckRepr]
+      )
+
+    def expand_event_types: (
+        QueryBuilders::Filters::Collection filters_collection
+      ) -> Array[QueryBuilders::Filters::FilterRow | QueryBuilders::Filters::MarkerFilterRow]
+
+    def partition_queries: -> PartitionQueries
+  end
+end

data/sig/pg_eventstore/queries/links_resolver.rbs

@@ -1,19 +1,15 @@
 module PgEventstore
   class LinksResolver
-    # _@param_ `connection`
-    def initialize: (PgEventstore::Connection connection) -> void
+    @query_strategy: QueryStrategy
 
-    # _@param_ `raw_events`
-    def resolve: (::Array[::Hash[untyped, untyped]] raw_events) -> ::Array[::Hash[untyped, untyped]]
+    attr_accessor connection: Connection
 
-    # _@param_ `link_events` — partition id to link events association
-    #
-    # _@return_ — original events
-    def load_original_events: (::Hash[Integer, ::Array[::Hash[untyped, untyped]]] link_events) -> ::Array[::Hash[untyped, untyped]]
+    def initialize: (Connection connection, QueryStrategy query_strategy) -> void
 
-    def partition_queries: () -> PgEventstore::PartitionQueries
+    def resolve: (::Array[::Hash[String, untyped]] raw_events) -> ::Array[::Hash[String, untyped]]
 
-    # Returns the value of attribute connection.
-    attr_accessor connection: PgEventstore::Connection
+    def load_original_events: (::Hash[Integer, ::Array[::Hash[String, untyped]]] link_events) -> ::Array[::Hash[String, untyped]]
+
+    def partition_queries: () -> PartitionQueries
   end
 end