pg_eventstore 1.13.4 → 3.0.0

data/lib/pg_eventstore/web/views/home/dashboard.erb

@@ -1,12 +1,12 @@
 <script type="text/html" id="stream-filter-tmpl">
   <%= erb :'home/partials/stream_filter', { layout: false }, { stream: {} } %>
 </script>
-<script type="text/html" id="system-stream-filter-tmpl">
-  <%= erb :'home/partials/system_stream_filter', { layout: false }, { stream: nil } %>
-</script>
 <script type="text/html" id="event-type-filter-tmpl">
   <%= erb :'home/partials/event_filter', { layout: false }, { event_type: '' } %>
 </script>
+<script type="text/html" id="markers-filter-tmpl">
+  <%= erb :'home/partials/markers_filter', { layout: false }, { markers: [] } %>
+</script>
 
 <div class="right_col" role="main">
   <div class="">
@@ -30,11 +30,6 @@
             <form id="filters-form" action="<%= url('/') %>" method="GET" data-parsley-validate class="form-horizontal form-label-left">
               <input type="hidden" name="per_page" value="<%= params[:per_page].to_i %>">
               <input type="hidden" name="resolve_link_tos" value="<%= resolve_link_tos? %>">
-              <div class="system-stream-filter">
-                <% if system_stream %>
-                  <%= erb :'home/partials/system_stream_filter', { layout: false }, { stream: system_stream } %>
-                <% end %>
-              </div>
               <div class="stream-filters">
                 <% streams_filter&.each do |attrs| %>
                   <%= erb :'home/partials/stream_filter', { layout: false }, { stream: attrs } %>
@@ -45,6 +40,11 @@
                   <%= erb :'home/partials/event_filter', { layout: false }, { event_type: event_type } %>
                 <% end %>
               </div>
+              <div class="markers-filter">
+                <% if markers_filter.any? %>
+                  <%= erb :'home/partials/markers_filter', { layout: false }, { markers: markers_filter } %>
+                <% end %>
+              </div>
               <div class="ln_solid"></div>
               <div class="item form-group">
                 <div class="col-md-6 col-sm-6 offset-md-5">
@@ -58,6 +58,7 @@
                         <a class="dropdown-item add-stream-filter" href="javascript: void(0)">Add stream filter</a>
                         <a class="dropdown-item add-system-stream-filter" href="javascript: void(0)">Add system stream filter</a>
                         <a class="dropdown-item add-event-filter" href="javascript: void(0)">Add event filter</a>
+                        <a class="dropdown-item add-markers-filter" href="javascript: void(0)">Add markers filter</a>
                       </div>
                     </div>
                   </div>
@@ -143,6 +144,7 @@
                     <a href="<%= sort_url('asc') %>"><i class="fa fa-sort-asc"></i></a>
                   <% end %>
                 </th>
+                <th>Subscription position</th>
                 <th>Stream revision</th>
                 <th>Context</th>
                 <th>Stream name</th>
@@ -154,7 +156,7 @@
               </tr>
               </thead>
               <tbody>
-                <%= erb :'home/partials/events', { layout: false }, { events: @collection.collection } %>
+                <%= erb :'home/partials/events', { layout: false }, { events: @collection.collection, gp_to_sp_map: @gp_to_sp_map } %>
               </tbody>
             </table>
           </div>

data/lib/pg_eventstore/web/views/home/partials/event_filter.erb

@@ -1,12 +1,25 @@
+<% type = event_type.is_a?(Hash) ? event_type[:type] : event_type %>
+<% markers = event_type.is_a?(Hash) ? event_type[:markers] : [] %>
 <div class="form-row align-items-center">
-  <div class="col-11">
-    <select name="filter[events][]" class="form-control mb-2" data-placeholder="Event type" data-url="<%= url('/event_types_filtering') %>" autocomplete="off">
+  <div class="col-5">
+    <select name="filter[events][][type]" class="form-control mb-2 type-filter" data-placeholder="Event type" data-url="<%= url('/event_types_filtering') %>" autocomplete="off">
       <option></option>
-      <% if event_type %>
-        <% if event_type == PgEventstore::Web::Application::EMPTY_STRING_SIGN %>
+      <% if type %>
+        <% if type == PgEventstore::Web::Application::EMPTY_STRING_SIGN %>
           <option class="zero-byte-val" selected></option>
         <% else %>
-          <option value="<%= h event_type %>" selected><%= h event_type %></option>
+          <option value="<%= h type %>" selected><%= h type %></option>
+        <% end %>
+      <% end %>
+    </select>
+  </div>
+  <div class="col-5">
+    <select name="filter[events][][markers][]" class="form-control mb-2 event-markers-filter" data-placeholder="Event markers" data-url="<%= url('/markers_filtering') %>" autocomplete="off" multiple>
+      <% markers.each do |marker| %>
+        <% if marker == PgEventstore::Web::Application::EMPTY_STRING_SIGN %>
+          <option class="zero-byte-val" selected></option>
+        <% else %>
+          <option value="<%= h marker %>" selected><%= h marker %></option>
         <% end %>
       <% end %>
     </select>

data/lib/pg_eventstore/web/views/home/partials/events.erb

@@ -1,11 +1,18 @@
 <% events.each do |event| %>
   <tr>
     <td><%= event.global_position %></td>
+    <td class="subscription-position">
+      <% if gp_to_sp_map[event.global_position] %>
+        <%= gp_to_sp_map[event.global_position] %>
+      <% else %>
+        <i>Not yet assigned</i>
+      <% end %>
+    </td>
     <td><%= event.stream_revision %></td>
     <td><%= empty_characters_fallback(h event.stream.context) %></td>
     <td><%= empty_characters_fallback(h event.stream.stream_name) %></td>
     <td>
-      <a href="<%= stream_path(event) %>"><%= empty_characters_fallback(h event.stream.stream_id) %></a>
+      <a href="<%= stream_path(event.stream) %>"><%= empty_characters_fallback(h event.stream.stream_id) %></a>
       <a role="button" href="#" data-title="Copy stream definition." class="copy-to-clipboard"
          data-clipboard-content="<%= h "PgEventstore::Stream.new(context: #{event.stream.context.inspect}, stream_name: #{event.stream.stream_name.inspect}, stream_id: #{event.stream.stream_id.inspect})" %>">
         <i class="fa fa-clipboard"></i>
@@ -37,6 +44,36 @@
       <pre><%= h JSON.pretty_generate(event.data) %></pre>
       <strong>Metadata:</strong>
       <pre><%= h JSON.pretty_generate(event.metadata) %></pre>
+      <strong>Markers:</strong>
+      <% if event.markers.any? || event.feature_markers.any? %>
+        <br>
+        <i>Total markers: <%= event.markers.size + event.feature_markers.size %>. List is scrollable</i>
+        <div style="max-height: 200px; overflow: scroll">
+          <% if event.feature_markers.any? %>
+            Feature markers
+            <ul>
+              <% event.feature_markers.each do |feature_marker| %>
+                <li>
+                  <%= "#{h feature_marker.description}:" if feature_marker.description %>
+                  <a href="<%= event_marker_path(feature_marker.marker) %>">
+                    <%= empty_characters_fallback(h feature_marker.marker) %>
+                  </a>
+                </li>
+              <% end %>
+            </ul>
+          <% end %>
+          <% if event.markers.any? %>
+            Event markers
+            <ul>
+              <% event.markers.each do |marker| %>
+                <li> <a href="<%= event_marker_path(marker) %>"><%= empty_characters_fallback(h marker) %></a> </li>
+              <% end %>
+            </ul>
+          <% end %>
+        </div>
+      <% else %>
+        <i>No markers assigned</i>
+      <% end %>
     </td>
   </tr>
 <% end %>

data/lib/pg_eventstore/web/views/home/partials/markers_filter.erb

@@ -0,0 +1,18 @@
+<div class="form-row align-items-center">
+  <div class="col-11">
+    <select name="filter[markers][]" class="form-control mb-2 markers-filter" data-placeholder="Event markers" data-url="<%= url('/markers_filtering') %>" autocomplete="off" multiple>
+      <% markers.each do |marker| %>
+        <% if marker == PgEventstore::Web::Application::EMPTY_STRING_SIGN %>
+          <option class="zero-byte-val" selected></option>
+        <% else %>
+          <option value="<%= h marker %>" selected><%= h marker %></option>
+        <% end %>
+      <% end %>
+    </select>
+  </div>
+  <div class="col-1">
+    <a class="btn btn-default remove-filter" href="javascript: void(0);">
+      <i class="fa fa-minus-circle"></i>
+    </a>
+  </div>
+</div>

data/lib/pg_eventstore/web/views/layouts/application.erb

@@ -59,6 +59,12 @@
                   Events lookup
                 </a>
               </li>
+              <li>
+                <a href="<%= url('/streams') %>">
+                  <i class="fa fa-search-plus"></i>
+                  Streams list
+                </a>
+              </li>
               <li>
                 <a href="<%= url('/subscriptions') %>">
                   <i class="fa fa-pencil-square-o"></i>

data/lib/pg_eventstore/web/views/streams/index.erb

@@ -0,0 +1,110 @@
+<div class="right_col" role="main">
+  <div class="">
+    <div class="page-title">
+      <div class="title_left">
+        <h3>Streams list</h3>
+      </div>
+    </div>
+
+    <div class="clearfix"></div>
+
+    <div class="row">
+      <div class="col-md-12 col-sm-12">
+        <div class="x_panel">
+          <div class="x_title">
+            <div class="row">
+              <div class="col-md-3 col-sm-12">
+                <h2>
+                  Streams
+                  <small id="total-count"><%= total_count(@collection.total_count) %></small>
+                </h2>
+                <div class="clearfix"></div>
+              </div>
+              <div class="col-md-6 col-sm-12">
+                <form class="form-horizontal form-label-left float-md-right">
+                  <div class="form-group float-md-right">
+                    <label class="control-label text-nowrap float-left mr-2" for="per_page_select">Per page</label>
+                    <select class="page-link text-dark float-left" name="per_page" id="per_page_select">
+                      <% PgEventstore::Web::Paginator::StreamsCollection::PER_PAGE.keys.each do |per_page| %>
+                        <option <%= 'selected="selected"' if params[:per_page] == per_page %> data-url="<%= per_page_url(per_page) %>">
+                          <%= per_page %>
+                        </option>
+                      <% end %>
+                    </select>
+                    <button type="submit" class="d-none"></button>
+                  </div>
+                </form>
+              </div>
+              <div class="col-md-3 col-sm-12">
+                <nav aria-label="Page navigation">
+                  <ul class="pagination justify-content-md-end" id="pagination">
+                    <%= erb :'home/partials/pagination_links', { layout: false }, { collection: @collection } %>
+                  </ul>
+                </nav>
+                <div class="clearfix"></div>
+              </div>
+              <div class="clearfix"></div>
+            </div>
+          </div>
+          <div class="x_content table-responsive">
+            <table class="table table-hover" id="events-table">
+              <thead>
+              <tr>
+                <th>
+                  Starting position
+                  <% if params[:order] == 'asc' %>
+                    <a href="<%= sort_url('desc') %>"><i class="fa fa-sort-desc"></i></a>
+                  <% else %>
+                    <a href="<%= sort_url('asc') %>"><i class="fa fa-sort-asc"></i></a>
+                  <% end %>
+                </th>
+                <th>Context</th>
+                <th>Stream name</th>
+                <th>Stream ID</th>
+                <th>Stream revision</th>
+              </tr>
+              </thead>
+              <tbody>
+              <%= erb :'streams/partials/streams', { layout: false }, { streams: @collection.collection } %>
+              </tbody>
+            </table>
+          </div>
+        </div>
+      </div>
+
+      <div class="clearfix"></div>
+    </div>
+  </div>
+</div>
+
+<div class="modal fade" id="delete-event-modal" tabindex="-1" role="dialog" aria-labelledby="delete-event-modal" aria-hidden="true">
+  <div class="modal-dialog modal-dialog-centered" role="document">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title">Delete Event</h5>
+        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
+          <span aria-hidden="true">&times;</span>
+        </button>
+      </div>
+      <div class="modal-body font-weight-bold text-break">
+        <h5>
+          You are about to delete Event on global position <span class="global-position-text"></span>. This action is irreversible. Continue?
+        </h5>
+
+        <form id="delete-event-form" data-parsley-validate="" class="form-horizontal form-label-left" novalidate="" method="POST">
+          <input type="hidden" name="data[force]" value="false">
+          <div class="checkbox">
+            <label>
+              <input type="checkbox" id="force-delete" name="data[force]" autocomplete="off" value="true">
+              Ignore limitations(see <a class="text-info" href="https://github.com/yousty/pg_eventstore/blob/main/docs/maintenance.md#deleting-an-event-in-a-large-stream" target="_blank" rel="noreferrer,nofollow">docs</a>).
+            </label>
+          </div>
+        </form>
+      </div>
+      <div class="modal-footer">
+        <button type="button" class="btn btn-secondary" data-dismiss="modal">Cancel</button>
+        <button type="submit" class="btn btn-danger" form="delete-event-form">Delete</button>
+      </div>
+    </div>
+  </div>
+</div>

data/lib/pg_eventstore/web/views/streams/partials/streams.erb

@@ -0,0 +1,11 @@
+<% streams.each do |stream| %>
+  <tr>
+    <td><%= stream.starting_position %></td>
+    <td><%= empty_characters_fallback(h stream.context) %></td>
+    <td><%= empty_characters_fallback(h stream.stream_name) %></td>
+    <td>
+      <a href="<%= stream_path(stream) %>" target="_blank"><%= empty_characters_fallback(h stream.stream_id) %></a>
+    </td>
+    <td><%= stream.stream_revision %></td>
+  </tr>
+<% end %>

data/lib/pg_eventstore/web/views/subscriptions/index.erb

@@ -139,7 +139,10 @@
                           <th>Pull interval</th>
                           <th>Last event arrived at</th>
                           <th>State</th>
-                          <th>Performance</th>
+                          <th>
+                            Performance
+                            <i class="fa fa-question-circle" data-toggle="tooltip" title="Subscription handler performance"></i>
+                          </th>
                           <th>Restarts count</th>
                           <th>Max restarts number</th>
                           <th>Time between restarts</th>

data/lib/pg_eventstore/web.rb

@@ -5,10 +5,12 @@ require 'sinatra/base'
 require_relative 'web/paginator/helpers'
 require_relative 'web/paginator/base_collection'
 require_relative 'web/paginator/events_collection'
+require_relative 'web/paginator/streams_collection'
 require_relative 'web/paginator/stream_contexts_collection'
 require_relative 'web/paginator/stream_names_collection'
 require_relative 'web/paginator/stream_ids_collection'
 require_relative 'web/paginator/event_types_collection'
+require_relative 'web/paginator/markers_collection'
 require_relative 'web/subscriptions/set_collection'
 require_relative 'web/subscriptions/subscriptions'
 require_relative 'web/subscriptions/subscriptions_set'

data/lib/pg_eventstore.rb

@@ -1,17 +1,26 @@
 # frozen_string_literal: true
 
+require 'securerandom'
 require_relative 'pg_eventstore/version'
 require_relative 'pg_eventstore/utils'
 require_relative 'pg_eventstore/callbacks'
 require_relative 'pg_eventstore/extensions/options_extension'
+require_relative 'pg_eventstore/extensions/options_defaults'
 require_relative 'pg_eventstore/extensions/callbacks_extension'
 require_relative 'pg_eventstore/extensions/callback_handlers_extension'
 require_relative 'pg_eventstore/extensions/using_connection_extension'
 require_relative 'pg_eventstore/event_class_resolver'
+require_relative 'pg_eventstore/basic_config'
 require_relative 'pg_eventstore/config'
 require_relative 'pg_eventstore/partition'
 require_relative 'pg_eventstore/event'
+require_relative 'pg_eventstore/raw_event'
 require_relative 'pg_eventstore/stream'
+require_relative 'pg_eventstore/event_global_index'
+require_relative 'pg_eventstore/stream_global_index'
+require_relative 'pg_eventstore/event_marker_index'
+require_relative 'pg_eventstore/event_marker'
+require_relative 'pg_eventstore/feature_marker'
 require_relative 'pg_eventstore/commands'
 require_relative 'pg_eventstore/queries'
 require_relative 'pg_eventstore/client'
@@ -19,68 +28,24 @@ require_relative 'pg_eventstore/maintenance'
 require_relative 'pg_eventstore/connection'
 require_relative 'pg_eventstore/errors'
 require_relative 'pg_eventstore/middleware'
+require_relative 'pg_eventstore/middleware/event_tracing'
+require_relative 'pg_eventstore/synchronized_array'
+require_relative 'pg_eventstore/chunks'
 require_relative 'pg_eventstore/subscriptions/subscriptions_manager'
+require_relative 'pg_eventstore/extensions/acts_as_configurable'
+require_relative 'pg_eventstore/async_runner'
+require_relative 'pg_eventstore/query_strategy'
+require_relative 'pg_eventstore_ext'
 
 module PgEventstore
-  # @return [Symbol]
-  DEFAULT_CONFIG = :default
+  extend Extensions::ActsAsConfigurable
 
-  class << self
-    # @!attribute mutex
-    #   @return [Thread::Mutex]
-    attr_reader :mutex
-    private :mutex
+  acts_as_configurable(config_class: Config)
 
+  class << self
     # @return [Logger, nil]
     attr_accessor :logger
 
-    # Creates a Config if not exists and yields it to the given block.
-    # @param name [Symbol] a name to assign to a config
-    # @return [Object] a result of the given block
-    def configure(name: DEFAULT_CONFIG)
-      mutex.synchronize do
-        @config[name] = @config[name] ? Config.new(name: name, **@config[name].options_hash) : Config.new(name: name)
-        connection_config_was = @config[name].connection_options
-
-        yield(@config[name]).tap do
-          @config[name].freeze
-          next if connection_config_was == @config[name].connection_options
-
-          # Reset the connection if user decided to reconfigure connection's options
-          @connection.delete(name)
-        end
-      end
-    end
-
-    # @return [Array<Symbol>]
-    def available_configs
-      @config.keys
-    end
-
-    # @param name [Symbol]
-    # @return [PgEventstore::Config]
-    def config(name = DEFAULT_CONFIG)
-      return @config[name] if @config[name]
-
-      error_message = <<~TEXT
-        Could not find #{name.inspect} config. You can define it like this:
-        PgEventstore.configure(name: #{name.inspect}) do |config|
-          # your config goes here
-        end
-      TEXT
-      raise error_message
-    end
-
-    # Look ups and returns a Connection, based on the given config. If not exists - it creates one. This operation is a
-    # thread-safe
-    # @param name [Symbol]
-    # @return [PgEventstore::Connection]
-    def connection(name = DEFAULT_CONFIG)
-      mutex.synchronize do
-        @connection[name] ||= Connection.new(**config(name).connection_options)
-      end
-    end
-
     # @param config_name [Symbol]
     # @param subscription_set [String]
     # @param max_retries [Integer, nil] max number of retries of failed SubscriptionsSet
@@ -92,9 +57,9 @@ module PgEventstore
       SubscriptionsManager.new(
         config: config(config_name),
         set_name: subscription_set,
-        max_retries: max_retries,
-        retries_interval: retries_interval,
-        force_lock: force_lock
+        max_retries:,
+        retries_interval:,
+        force_lock:
       )
     end
 
@@ -112,12 +77,10 @@ module PgEventstore
 
     private
 
-    # @return [void]
-    def init_variables
-      @config = { DEFAULT_CONFIG => Config.new(name: DEFAULT_CONFIG) }
-      @connection = {}
-      @mutex = Thread::Mutex.new
+    # @param config [Config]
+    # @return [Hash]
+    def connection_options(config)
+      { uri: config.pg_uri, pool_size: config.connection_pool_size, pool_timeout: config.connection_pool_timeout }
     end
   end
-  init_variables
 end

data/pg_eventstore.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.description = 'EventStore implementation using PostgreSQL'
   spec.homepage = 'https://github.com/yousty/pg_eventstore'
   spec.license = 'MIT'
-  spec.required_ruby_version = '>= 3.0'
+  spec.required_ruby_version = '>= 3.3'
 
   spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
@@ -27,15 +27,17 @@ Gem::Specification.new do |spec|
       bin/ test/ spec/ features/ .git .circleci appveyor Gemfile .ruby-version .ruby-gemset .rspec docker-compose.yml
       Rakefile benchmark/ .yardopts db/structure.sql config.ru docs/images/
     ]
-    `git ls-files -z`.split("\x0").reject do |f|
+    files = `git ls-files -z`.split("\x0") + Dir['ext/**/*.{c,rb}']
+    files.uniq.reject do |f|
       (File.expand_path(f) == __FILE__) || f.start_with?(*paths_to_exclude) || File.extname(f) == '.map'
     end
   end
   spec.bindir = 'exe'
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.extensions = ['ext/pg_eventstore_ext/extconf.rb']
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'connection_pool', '~> 2.4'
-  spec.add_dependency 'pg', '~> 1.5'
+  spec.add_dependency 'connection_pool', '>= 2.5.4', '< 4'
+  spec.add_dependency 'pg', '~> 1'
   spec.add_dependency 'sinatra', '>= 3', '< 5'
 end

data/sig/interfaces/_raw_events_handler.rbs

@@ -0,0 +1,3 @@
+interface _RawEventsHandler
+  def call: (Array[Hash[String, untyped]] events) -> void
+end

data/sig/interfaces/subscription_handler.rbs

@@ -1,3 +1,3 @@
 interface _SubscriptionHandler
-  def call: (PgEventstore::Event event) -> void
+  def call: (PgEventstore::Event | Array[PgEventstore::Event] event) -> void
 end

data/sig/pg/result.rbs

@@ -0,0 +1,9 @@
+module PG
+  class Result
+    def map_types!: (untyped type_map) -> self
+
+    def field_names_as: (Symbol type_map) -> self
+
+    def inspect: -> String
+  end
+end

data/sig/pg_eventstore/async_runner.rbs

@@ -0,0 +1,13 @@
+module PgEventstore
+  class AsyncRunner
+    @jobs: Hash[Fiber, bool]
+
+    def async: () { -> void } -> void
+
+    def jobs_size: -> Integer
+
+    def run: -> void
+
+    def run_once: -> void
+  end
+end

data/sig/pg_eventstore/basic_config.rbs

@@ -0,0 +1,9 @@
+module PgEventstore
+  class BasicConfig
+    include Extensions::OptionsExtension
+
+    attr_reader name: Symbol
+
+    def initialize: (name: Symbol, **untyped options) -> void
+  end
+end

data/sig/pg_eventstore/chunks/chunk.rbs

@@ -0,0 +1,13 @@
+module PgEventstore
+  module Chunks
+    module Chunk[unchecked ElemIn, unchecked ElemOut]
+      def drained?: -> bool
+
+      def last: -> ElemIn?
+
+      def size: -> Integer
+
+      def take: (Integer? size) -> Array[ElemOut]
+    end
+  end
+end

data/sig/pg_eventstore/chunks/read_api_events_index_chunk.rbs

@@ -0,0 +1,30 @@
+module PgEventstore
+  module Chunks
+    class ReadApiEventsIndexChunk
+      include Chunk[EventGlobalIndex::ReadApiRepr, Hash[String, untyped]]
+
+      MAX_PARTITIONS_TO_RESOLVE_PER_CALL: Integer
+
+      @connection: Connection
+      @raw_events: Array[Hash[String, untyped]]
+      @idx_direction: Symbol
+      @indexes: Array[EventGlobalIndex::ReadApiRepr]
+      @query_strategy: QueryStrategy
+      @resolve_link_tos: bool
+      @resolved: bool
+
+      def initialize: (Array[EventGlobalIndex::ReadApiRepr] indexes, Connection connection,
+          QueryStrategy query_strategy, bool resolve_link_tos) -> void
+
+      private
+
+      def detect_direction: (EventGlobalIndex::ReadApiRepr? idx1, EventGlobalIndex::ReadApiRepr? idx2) -> Symbol
+
+      def events_global_index_queries: -> EventsGlobalIndexQueries
+
+      def resolve_indexes: -> void
+
+      def resolved?: -> bool
+    end
+  end
+end

data/sig/pg_eventstore/chunks/replica_events_index_chunk.rbs

@@ -0,0 +1,11 @@
+module PgEventstore
+  module Chunks
+    class ReplicaEventsIndexChunk
+      include Chunk[EventGlobalIndex::SubscriptionRepr, EventGlobalIndex::SubscriptionRepr]
+
+      @indexes: Array[EventGlobalIndex::SubscriptionRepr]
+
+      def initialize: (Array[EventGlobalIndex::SubscriptionRepr] indexes) -> void
+    end
+  end
+end

data/sig/pg_eventstore/chunks/repository.rbs

@@ -0,0 +1,22 @@
+module PgEventstore
+  module Chunks
+    class Repository
+      include MonitorMixin
+
+      @chunks: SynchronizedArray[Chunk[untyped, untyped]]
+
+      def add_chunk: (Chunk[untyped, untyped] chunk, ?condition: MonitorMixin::ConditionVariable?) -> void
+
+      def clear: -> void
+
+      def consume_all: -> untyped
+
+      def empty?: -> bool
+
+      def size: -> Integer
+
+      def wait_and_consume: (entities_num: Integer?, timeout: Float | Integer,
+          condition: MonitorMixin::ConditionVariable) -> Array[untyped]
+    end
+  end
+end

data/sig/pg_eventstore/chunks/subscription_checkpoint_chunk.rbs

@@ -0,0 +1,18 @@
+module PgEventstore
+  module Chunks
+    class SubscriptionCheckpointChunk
+      class Checkpoint
+        include Extensions::OptionsExtension
+        include Extensions::OptionsDefaults
+
+        attr_reader subscription_position: Integer
+      end
+
+      include Chunk[Checkpoint, Checkpoint]
+
+      @checkpoint_event: Checkpoint?
+
+      def initialize: (Integer position) -> void
+    end
+  end
+end