pg_eventstore 1.7.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff514958069cbf4b819b2ad959eac80ca9f24445bca19690ed4cb3ff23989804
-  data.tar.gz: bd91be800c3739a43edf4c17c996156642f00f0d977446201c84784a1bcc6e74
+  metadata.gz: 7c0936a5580f6340a43f65d5b1b3362855b30e78fb25bdd498bf21c759458fcb
+  data.tar.gz: d18a05c7c6917e66c83de05013afcf6b9f25aaf7027e32fb1345553f5398a120
 SHA512:
-  metadata.gz: 1d4946c58c314f0bfb04c0c20ca1308e4c8afe915adacee8722fcd703404b26dbc429bdda5bc5a44f94654cb366813065226b42c930620bf30fcd4a345f592b1
-  data.tar.gz: 89738f55a626cbcd4eab9d336b7f4b9ff2e3520fc30a7fc7d87dfac5e755cd6431392438d1522cec706188aa855942db4cfd6fa96bc83c5e0b67086d6e05cef8
+  metadata.gz: b11fcbc08f2853a69c288dcd08498a5e40277cdeaf32ccba71ade48eac03cf3fd0c157abe0058daedb27aca945406afa8f3078f149e045ff63d89a47ca12da36
+  data.tar.gz: c021e192cfd8f61364235fa7ccdd2d97a37c39fe304f9167fe7cda508acd7c65b84bc2d168687a1cec185cf07870183b70fc849508a434ea13935398687cbea4

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [1.9.0]
+
+- Implement an ability to delete a stream
+- Implement an ability to delete an event
+- Add "Delete event" and "Delete stream" buttons into admin UI
+
+## [1.8.0]
+- Introduce default config for admin web UI. Now if you define `:admin_web_ui` config - it will be preferred over default config
+- Fix pagination of events in admin UI
+- Improve partial index for `$streams` system stream
+
 ## [1.7.0]
 - Implement reading from `"$streams"` system stream
 - Disable Host authorization introduced in sinatra v4.1

data/README.md

@@ -45,6 +45,7 @@ Documentation chapters:
 - [Linking events](docs/linking_events.md)
 - [Reading events](docs/reading_events.md)
 - [Subscriptions](docs/subscriptions.md)
+- [Maintenance functions](docs/maintenance.md)
 - [Writing middlewares](docs/writing_middleware.md)
 - [How to make multiple commands atomic](docs/multiple_commands.md)
 - [Admin UI](docs/admin_ui.md)

data/db/migrations/8_improve_0_revision_partial_index.sql

@@ -0,0 +1,2 @@
+DROP INDEX IF EXISTS idx_events_0_stream_revision_global_position;
+CREATE INDEX idx_events_0_stream_revision_global_position ON events USING btree (global_position) WHERE stream_revision = 0;

data/docs/admin_ui.md

@@ -10,7 +10,13 @@
 
 ## Authorization
 
-Admin UI is implemented as a rack application. It doesn't have any built-in authentication/authorization mechanism - it is your responsibility to take care of it.
+Admin UI is implemented as a rack application. It doesn't have any built-in authentication/authorization mechanism - it is your responsibility to take care of it. Admin UI tries to look for `:admin_web_ui` config with a fallback to `:default` config. Thus, you can setup Admin UI-specific config, e.g. without some middlewares or so. Example:
+
+```ruby
+PgEventstore.configure(name: :admin_web_ui) do |config|
+  config.middlewares = { my_admin_ui_middleware: AdminUIMiddleware.new }
+end
+```
 
 ### Rails integration
 

data/docs/configuration.md

@@ -45,6 +45,9 @@ Tell `PgEventstore` which config you want to use:
 PgEventstore.client(:pg_db_1).read(PgEventstore::Stream.all_stream)
 # Read from "all" stream using :pg_db_2 config
 PgEventstore.client(:pg_db_2).read(PgEventstore::Stream.all_stream)
+# Delete a stream using :pg_db_1 config
+stream = PgEventstore::Stream.new(context: 'FooCtx', stream_name: 'MyStream', stream_id: '1')
+PgEventstore.maintenance.delete_stream(stream)
 ```
 
 ### Default config

data/docs/events_and_streams.md

@@ -16,7 +16,9 @@
 - `stream_revision` - Integer(optional, read only). A revision of an event inside its stream.
 - `data` - Hash(optional). Event's payload data. For example, if you have a `DescriptionChanged` event class, then you may want to have a description value in the event payload data. Example: `DescriptionChanged.new(data: { 'description' => 'Description of something', 'post_id' => SecureRandom.uuid })`
 - `metadata` - Hash(optional). Event metadata. Event meta information which is not part of an events data payload. Example: `{ published_by: publishing_user.id }`
-- `link_id` - String(UUIDv4, optional, read only). If an event is a link event (link events are pointers to other events), this attribute contains the `id` of the original event. Manually assigning this attribute has no effect. It is internally set when appending an event to the given stream or when reading events from the database.
+- `link_id` - String(UUIDv4, optional, read only). If an event is a link event (link events are pointers to other events), this attribute contains an `id` of the original event. Manually assigning this attribute has no effect. It is internally set when appending an event to the given stream or when reading events from the database.
+- `link_partition_id` - Integer(optional, read only). If an event is a link event - this attribute contains a partition `id` of original event. Manually assigning this attribute has no effect. It is internally set when appending an event to the given stream or when reading events from the database.
+- `link` - PgEventstore::Event(optional, read only). When reading from a stream using `resolve_link_tos: true`, if an event is resolved from a link - this attribute contains a `PgEventstore::Event` object which corresponds to that link. Manually assigning this attribute has no effect. It is internally set when reading events from the database.
 - `created_at` - Time(optional, read only). Database's timestamp when an event was appended to a stream. You may want to put your own timestamp into a `metadata` attribute - it may be useful when migrating between different databases. Manually assigning this attribute has no effect. It is internally set when appending an event to the given stream or when reading events from the database.
 
 Example:
@@ -40,7 +42,21 @@ PgEventstore::Stream.new(context: 'Sales', stream_name: 'Customer', stream_id: '
 PgEventstore::Stream.new(context: 'Sales', stream_name: 'Customer', stream_id: 'f37b82f2-4152-424d-ab6b-0cc6f0a53aae')
 ```
 
-There is a special stream, called the "all" stream. You can get this object by calling the`PgEventstore::Stream.all_stream` method. Read more about the "all" stream in the `Reading from the "all" stream` section of [Reading events](reading_events.md) chapter.
+### "all" stream
+
+There is a special stream, called the "all" stream. You can get this object by calling the `PgEventstore::Stream.all_stream` method. Read more about the "all" stream in the `Reading from the "all" stream` section of [Reading events](reading_events.md) chapter.
+
+### System streams
+
+System stream is a special stream, the representation of which is pre-defined by the gem. System stream object can be created in next way:
+
+```ruby
+PgEventstore::Stream.system_stream(stream_name)
+```
+
+Current list of system streams is:
+
+- `"$streams"`. Reading from this stream will return 0 revision events. This allows effectively loop through a list of streams. Read more in [Reading events](reading_events.md#streams-stream-filtering) chapter.
 
 ## Important note
 

data/docs/maintenance.md

@@ -0,0 +1,51 @@
+# Maintenance
+
+`pg_eventstore` provides maintenance functional which can be used to clean up various objects in your database.
+
+## Delete a stream
+
+```ruby
+stream = PgEventstore::Stream.new(context: 'FooCtx', stream_name: 'MyStream', stream_id: '1')
+PgEventstore.client.append_to_stream(stream, PgEventstore::Event.new)
+PgEventstore.maintenance.delete_stream(stream) # => true
+```
+deletes all events in the given stream. If the given stream does not exist - `false` is returned: 
+
+```ruby
+stream = PgEventstore::Stream.new(context: 'NonExistingCtx', stream_name: 'NonExistingStream', stream_id: '1')
+PgEventstore.maintenance.delete_stream(stream) # => false
+```
+
+**Please note that this operation does not automatically delete links to deleted events - you have to do delete them separately.**
+
+## Delete an event
+
+```ruby
+stream = PgEventstore::Stream.new(context: 'FooCtx', stream_name: 'MyStream', stream_id: '1')
+PgEventstore.client.append_to_stream(stream, PgEventstore::Event.new)
+# Grab the first event for further deletion
+event = PgEventstore.client.read(stream, options: { max_count: 1 }).first
+PgEventstore.maintenance.delete_event(event) # => true
+```
+deletes the given event. If the given event does not exist - `false` is returned:
+
+```ruby
+stream = PgEventstore::Stream.new(context: 'FooCtx', stream_name: 'MyStream', stream_id: '1')
+PgEventstore.client.append_to_stream(stream, PgEventstore::Event.new)
+# Grab the first event for further deletion
+event = PgEventstore.client.read(stream, options: { max_count: 1 }).first
+PgEventstore.maintenance.delete_event(event) # => true
+PgEventstore.maintenance.delete_event(event) # => false
+```
+
+**Please note that this operation does not automatically delete links to the deleted event - you have to do delete them separately.**
+
+### Deleting an event in a large stream
+
+There can be a situation when you would like to delete an event in a large stream. If an event is in the position where there are 1000+ events after it in a stream - a `PgEventstore::TooManyRecordsToLockError` error will be raised. This is because in addition to removing the event, we need to adjust the rest of the stream by updating the `#stream_revision` of all events that come after this event. To overcome this limitation - you can provide `force: true` flag:
+
+```ruby
+PgEventstore.maintenance.delete_event(event, force: true)
+```
+
+Because the update operation can lock thousands of events - `#delete_event` can be slow and can slow down other processes which insert events in the same stream at the same moment. **Thus, it is recommended to avoid using `#delete_event` in your business logic.**

data/docs/multiple_commands.md

@@ -44,3 +44,7 @@ old_email =
 # Sending email outside multiple block to prevent potential re-triggering of it 
 UserMailer.notify_email_changed(user.id, old_email: old_email, new_email: user.email).deliver_later
 ```
+
+## Side effect of internal implementation
+
+Please note that when publishing an event with a type as part of a `multiple` block that does not yet exist in the database, the block will run twice as the first attempt to publish will always fail due to the way `append_to_stream` is implemented. Consider this when writing expectations in your tests for example.

data/lib/pg_eventstore/client.rb

@@ -1,9 +1,7 @@
 # frozen_string_literal: true
 
-require_relative 'commands'
 require_relative 'event_serializer'
 require_relative 'event_deserializer'
-require_relative 'queries'
 
 module PgEventstore
   class Client

data/lib/pg_eventstore/commands/delete_event.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module PgEventstore
+  module Commands
+    # @!visibility private
+    class DeleteEvent < AbstractCommand
+      # Determines max allowed number of records to lock during an update. If the threshold is reached - an error is
+      # raised.
+      # @return [Integer]
+      MAX_RECORDS_TO_LOCK = 1_000
+
+      # @param event [PgEventstore::Event]
+      # @param force [Boolean]
+      # @return [Boolean]
+      def call(event, force:)
+        queries.transactions.transaction do
+          event = queries.maintenance.reload_event(event)
+          next false unless event
+
+          check_records_number_to_lock(event) unless force
+          queries.maintenance.delete_event(event)
+          queries.maintenance.adjust_stream_revisions(event.stream, event.stream_revision)
+          true
+        end
+      end
+
+      private
+
+      # @param event [PgEventstore::Event]
+      # @return [void]
+      # @raise [PgEventstore::TooManyRecordsToLockError]
+      def check_records_number_to_lock(event)
+        records_to_lock = queries.maintenance.events_to_lock_count(event.stream, event.stream_revision)
+        raise TooManyRecordsToLockError.new(event.stream, records_to_lock) if records_to_lock > MAX_RECORDS_TO_LOCK
+      end
+    end
+  end
+end

data/lib/pg_eventstore/commands/delete_stream.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module PgEventstore
+  module Commands
+    # @!visibility private
+    class DeleteStream < AbstractCommand
+      # @param stream [PgEventstore::Stream]
+      # @return [Boolean]
+      def call(stream)
+        raise SystemStreamError, stream if stream.system?
+
+        queries.transactions.transaction do
+          queries.maintenance.delete_stream(stream) > 0
+        end
+      end
+    end
+  end
+end

data/lib/pg_eventstore/commands.rb

@@ -9,3 +9,5 @@ require_relative 'commands/regular_stream_read_paginated'
 require_relative 'commands/system_stream_read_paginated'
 require_relative 'commands/multiple'
 require_relative 'commands/link_to'
+require_relative 'commands/delete_stream'
+require_relative 'commands/delete_event'

data/lib/pg_eventstore/errors.rb

@@ -41,7 +41,7 @@ module PgEventstore
     # @param stream [PgEventstore::Stream]
     def initialize(stream)
       @stream = stream
-      super("Stream #{stream.inspect} is a system stream and can't be used to append events.")
+      super("Can't perform this action with #{stream.inspect} system stream.")
     end
   end
 
@@ -225,4 +225,22 @@ module PgEventstore
 
   class EmptyChunkFedError < Error
   end
+
+  class TooManyRecordsToLockError < Error
+    attr_reader :stream
+    attr_reader :number_of_records
+
+    # @param stream [PgEventstore::Stream]
+    # @param number_of_records [Integer]
+    def initialize(stream, number_of_records)
+      @stream = stream
+      @number_of_records = number_of_records
+      super(user_friendly_message)
+    end
+
+    # @return [String]
+    def user_friendly_message
+      "Too many records of #{stream.to_hash.inspect} stream to lock: #{number_of_records}"
+    end
+  end
 end

data/lib/pg_eventstore/maintenance.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module PgEventstore
+  class Maintenance
+    # @!attribute config
+    #   @return [PgEventstore::Config]
+    attr_reader :config
+    private :config
+
+    # @param config [PgEventstore::Config]
+    def initialize(config)
+      @config = config
+    end
+
+    # @param stream [PgEventstore::Stream]
+    # @return [Boolean] whether a stream was deleted successfully
+    def delete_stream(stream)
+      Commands::DeleteStream.new(
+        Queries.new(transactions: transaction_queries, maintenance: maintenance_queries)
+      ).call(stream)
+    end
+
+    # @param event [PgEventstore::Event] persisted event
+    # @return [Boolean] whether an event was deleted successfully
+    def delete_event(event, force: false)
+      Commands::DeleteEvent.new(
+        Queries.new(transactions: transaction_queries, maintenance: maintenance_queries)
+      ).call(event, force: force)
+    end
+
+    private
+
+    # @return [PgEventstore::MaintenanceQueries]
+    def maintenance_queries
+      MaintenanceQueries.new(connection)
+    end
+
+    # @return [PgEventstore::TransactionQueries]
+    def transaction_queries
+      TransactionQueries.new(connection)
+    end
+
+    # @return [PgEventstore::Connection]
+    def connection
+      PgEventstore.connection(config.name)
+    end
+  end
+end

data/lib/pg_eventstore/queries/maintenance_queries.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module PgEventstore
+  # @!visibility private
+  class MaintenanceQueries
+    # @!attribute connection
+    #   @return [PgEventstore::Connection]
+    attr_reader :connection
+    private :connection
+
+    # @param connection [PgEventstore::Connection]
+    def initialize(connection)
+      @connection = connection
+    end
+
+    # @param stream [PgEventstore::Stream]
+    # @return [Integer] number of deleted events of the given stream
+    def delete_stream(stream)
+      connection.with do |conn|
+        conn.exec_params(<<~SQL, stream.deconstruct)
+          DELETE FROM events WHERE context = $1 AND stream_name = $2 AND stream_id = $3
+        SQL
+      end.cmd_tuples
+    end
+
+    # @param event [PgEventstore::Event]
+    # @return [Integer] number of deleted events
+    def delete_event(event)
+      connection.with do |conn|
+        conn.exec_params(<<~SQL, [event.stream.context, event.stream.stream_name, event.type, event.global_position])
+          DELETE FROM events WHERE context = $1 AND stream_name = $2 AND type = $3 AND global_position = $4
+        SQL
+      end.cmd_tuples
+    end
+
+    # @param stream [PgEventstore::Stream]
+    # @param after_revision [Integer]
+    # @return [void]
+    def adjust_stream_revisions(stream, after_revision)
+      connection.with do |conn|
+        conn.exec_params(<<~SQL, [stream.context, stream.stream_name, stream.stream_id, after_revision])
+          UPDATE events SET stream_revision = stream_revision - 1
+            WHERE context = $1 AND stream_name = $2
+              AND stream_id = $3 AND stream_revision > $4
+        SQL
+      end
+    end
+
+    # @param stream [PgEventstore::Stream]
+    # @param after_revision [Integer]
+    # @return [Integer]
+    def events_to_lock_count(stream, after_revision)
+      connection.with do |conn|
+        conn.exec_params(<<~SQL, [*stream.deconstruct, after_revision])
+          EXPLAIN SELECT * FROM events
+                    WHERE context = $1 AND stream_name = $2 AND stream_id = $3 AND stream_revision > $4
+        SQL
+      end.to_a.first['QUERY PLAN'].match(/rows=(\d+)/)[1].to_i
+    end
+
+    # @param event [PgEventstore::Event]
+    # @return [PgEventstore::Event]
+    def reload_event(event)
+      event_attrs = connection.with do |conn|
+        conn.exec_params(<<~SQL, [event.stream&.context, event.stream&.stream_name, event.type, event.global_position])
+          SELECT * FROM events WHERE context = $1 AND stream_name = $2 AND type = $3 AND global_position = $4 LIMIT 1
+        SQL
+      end.to_a.first
+      return unless event_attrs
+
+      basic_deserializer.deserialize(event_attrs)
+    end
+
+    private
+
+    # @return [PgEventstore::EventDeserializer]
+    def basic_deserializer
+      EventDeserializer.new([], ->(_event_type) { Event })
+    end
+  end
+end

data/lib/pg_eventstore/queries.rb

@@ -6,6 +6,7 @@ require_relative 'queries/transaction_queries'
 require_relative 'queries/event_queries'
 require_relative 'queries/partition_queries'
 require_relative 'queries/links_resolver'
+require_relative 'queries/maintenance_queries'
 
 module PgEventstore
   # @!visibility private
@@ -21,5 +22,9 @@ module PgEventstore
     # @!attribute transactions
     #   @return [PgEventstore::TransactionQueries, nil]
     attribute(:transactions)
+
+    # @!attribute maintenance
+    #   @return [PgEventstore::MaintenanceQueries, nil]
+    attribute(:maintenance)
   end
 end

data/lib/pg_eventstore/version.rb

@@ -2,5 +2,5 @@
 
 module PgEventstore
   # @return [String]
-  VERSION = "1.7.0"
+  VERSION = "1.9.0"
 end

data/lib/pg_eventstore/web/application.rb

@@ -1,10 +1,18 @@
 # frozen_string_literal: true
 
 require 'securerandom'
+require 'base64'
 
 module PgEventstore
   module Web
     class Application < Sinatra::Base
+      # @return [Symbol]
+      DEFAULT_ADMIN_UI_CONFIG = :admin_web_ui
+      # @return [String]
+      COOKIES_CONFIG_KEY = 'current_config'
+      # @return [String]
+      COOKIES_FLASH_MESSAGE_KEY = 'flash_message'
+
       set :static_cache_control, [:private, max_age: 86400]
       set :environment, -> { (ENV['RACK_ENV'] || ENV['RAILS_ENV'] || ENV['APP_ENV'])&.to_sym || :development }
       set :logging, -> { environment == :development || environment == :test }
@@ -34,14 +42,23 @@ module PgEventstore
 
         # @return [Symbol]
         def current_config
-          config = request.cookies['current_config']&.to_s&.to_sym
-          PgEventstore.available_configs.include?(config) ? config : :default
+          resolve_config_by_name(request.cookies[COOKIES_CONFIG_KEY]&.to_s&.to_sym)
+        end
+
+        # @param config_name [Symbol, nil]
+        # @return [Symbol]
+        def resolve_config_by_name(config_name)
+          existing_config = [config_name, DEFAULT_ADMIN_UI_CONFIG].find do |name|
+            PgEventstore.available_configs.include?(name)
+          end
+
+          existing_config || PgEventstore::DEFAULT_CONFIG
         end
 
         # @param val [Object]
         # @return [void]
         def current_config=(val)
-          response.set_cookie('current_config', { value: val.to_s, http_only: true, same_site: :lax })
+          response.set_cookie(COOKIES_CONFIG_KEY, { value: val.to_s, http_only: true, same_site: :lax })
         end
 
         # @return [PgEventstore::Connection]
@@ -83,6 +100,14 @@ module PgEventstore
         def resolve_link_tos?
           params.key?(:resolve_link_tos) ? params[:resolve_link_tos] == 'true' : true
         end
+
+        # @param val [Hash]
+        def flash_message=(val)
+          val = Base64.urlsafe_encode64(val.to_json)
+          response.set_cookie(
+            COOKIES_FLASH_MESSAGE_KEY, { value: val, http_only: false, same_site: :lax, path: '/' }
+          )
+        end
       end
 
       get '/' do
@@ -137,9 +162,7 @@ module PgEventstore
       end
 
       post '/change_config' do
-        config = params[:config]&.to_sym
-        config = :default unless PgEventstore.available_configs.include?(config)
-        self.current_config = config
+        self.current_config = resolve_config_by_name(params[:config]&.to_s&.to_sym)
         redirect(redirect_back_url(fallback_url: '/'))
       end
 
@@ -231,6 +254,44 @@ module PgEventstore
 
         redirect redirect_back_url(fallback_url: url('/subscriptions'))
       end
+
+      post '/delete_event/:global_position' do
+        params in { data: { force: String => force } }
+        global_position = params[:global_position].to_i
+        force = force == 'true'
+        event = PgEventstore.client(current_config).read(
+          PgEventstore::Stream.all_stream, options: { max_count: 1, from_position: global_position }
+        ).first
+        if event&.global_position == global_position
+          begin
+            PgEventstore.maintenance(current_config).delete_event(event, force: force)
+            self.flash_message = {
+              message: "An event at global position #{event.global_position} has been deleted successfully.",
+              kind: 'success'
+            }
+          rescue TooManyRecordsToLockError => e
+            text = <<~TEXT
+              Could not delete an event at global position #{event.global_position} - too many \
+              records(~#{e.number_of_records}) to lock.
+            TEXT
+            self.flash_message = { message: text, kind: 'error' }
+          end
+        else
+          self.flash_message = { message: 'Failed to delete an event - event does not exist.', kind: 'warning' }
+        end
+        redirect(redirect_back_url(fallback_url: '/'))
+      end
+
+      post '/delete_stream/:context/:stream_name/:stream_id' do
+        attrs = Hash[params.slice(:context, :stream_name, :stream_id)].transform_keys(&:to_sym)
+        stream = PgEventstore::Stream.new(**attrs)
+        PgEventstore.maintenance(current_config).delete_stream(stream)
+        self.flash_message = {
+          message: "Stream #{stream.to_hash} has been successfully deleted.",
+          kind: 'success'
+        }
+        redirect(redirect_back_url(fallback_url: '/'))
+      end
     end
   end
 end

data/lib/pg_eventstore/web/paginator/events_collection.rb

@@ -34,8 +34,7 @@ module PgEventstore
         def collection
           @_collection ||= PgEventstore.client(config_name).read(
             @stream,
-            options: options.merge(from_position: starting_id, max_count: per_page, direction: order),
-            middlewares: []
+            options: options.merge(from_position: starting_id, max_count: per_page, direction: order)
           )
         end
 
@@ -60,7 +59,7 @@ module PgEventstore
           ).to_sql_builder.unselect.select('global_position').offset(1)
           sql, params = sql_builder.to_exec_params
           sql = "SELECT * FROM (#{sql}) events ORDER BY global_position #{order} LIMIT 1"
-          PgEventstore.connection.with  do |conn|
+          connection.with  do |conn|
             conn.exec_params(sql, params)
           end.to_a.dig(0, 'global_position')
         end

data/lib/pg_eventstore/web/public/javascripts/pg_eventstore.js

@@ -5,6 +5,11 @@ $(function(){
         let $contextSelect = $filter.find('select[name*="context"]');
         let $streamNameSelect = $filter.find('select[name*="stream_name"]');
         let $streamIdSelect = $filter.find('select[name*="stream_id"]');
+
+        let removeDeleteBtn = function(){
+            $filter.find('.delete-stream').remove();
+        }
+
         $contextSelect.select2({
             ajax: {
                 url: $contextSelect.data('url'),
@@ -58,6 +63,9 @@ $(function(){
             },
             allowClear: true
         });
+        $contextSelect.on('change.select2', removeDeleteBtn);
+        $streamNameSelect.on('change.select2', removeDeleteBtn);
+        $streamIdSelect.on('change.select2', removeDeleteBtn);
     }
 
     let initSystemStreamFilterAutocomplete = function($filter){
@@ -257,3 +265,61 @@ $(function(){
        window.location.href = $selected.data('url');
     });
 });
+
+// Event deletion handling
+$(function(){
+   "use strict";
+
+   let $deleteEventModal = $('#delete-event-modal');
+
+    $deleteEventModal.on('hide.bs.modal', function(){
+        $(this).find('.global-position-text').html('');
+        $(this).find('form').removeAttr('action');
+    });
+
+    $deleteEventModal.on('show.bs.modal', function(e){
+        let $clickedLink = $(e.relatedTarget);
+        $(this).find('.global-position-text').html($clickedLink.data('global-position'));
+        $(this).find('form').attr('action', $clickedLink.data('url'));
+    });
+});
+
+// Flash messages
+$(function () {
+    "use strict";
+
+    let message = Cookies.get(window.flashMessageCookie);
+    if (!message)
+        return;
+
+    try {
+        message = Uint8Array.fromBase64(message, { alphabet: "base64url" });
+        message = new TextDecoder().decode(message);
+        message = JSON.parse(message);
+    } catch (e) {
+        console.debug(message);
+        console.debug(e);
+        Cookies.remove(window.flashMessageCookie);
+        return;
+    }
+
+    let $flashMessage = $('#flash-message');
+    let alertClass;
+    switch(message.kind) {
+        case "error":
+            alertClass = "alert-danger";
+            break;
+        case "warning":
+            alertClass = "alert-warning";
+            break;
+        case "success":
+            alertClass = "alert-success";
+            break;
+        default:
+            alertClass = "alert-light";
+    }
+
+    $flashMessage.find('.message').text(message.message);
+    $flashMessage.addClass(alertClass).removeClass('d-none');
+    Cookies.remove(window.flashMessageCookie);
+});

data/lib/pg_eventstore/web/public/javascripts/vendor/js.cookie.min.js

@@ -0,0 +1,2 @@
+/*! js-cookie v3.0.5 | MIT */
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self,function(){var n=e.Cookies,o=e.Cookies=t();o.noConflict=function(){return e.Cookies=n,o}}())}(this,(function(){"use strict";function e(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var o in n)e[o]=n[o]}return e}var t=function t(n,o){function r(t,r,i){if("undefined"!=typeof document){"number"==typeof(i=e({},o,i)).expires&&(i.expires=new Date(Date.now()+864e5*i.expires)),i.expires&&(i.expires=i.expires.toUTCString()),t=encodeURIComponent(t).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);var c="";for(var u in i)i[u]&&(c+="; "+u,!0!==i[u]&&(c+="="+i[u].split(";")[0]));return document.cookie=t+"="+n.write(r,t)+c}}return Object.create({set:r,get:function(e){if("undefined"!=typeof document&&(!arguments.length||e)){for(var t=document.cookie?document.cookie.split("; "):[],o={},r=0;r<t.length;r++){var i=t[r].split("="),c=i.slice(1).join("=");try{var u=decodeURIComponent(i[0]);if(o[u]=n.read(c,u),e===u)break}catch(e){}}return e?o[e]:o}},remove:function(t,n){r(t,"",e({},n,{expires:-1}))},withAttributes:function(n){return t(this.converter,e({},this.attributes,n))},withConverter:function(n){return t(e({},this.converter,n),this.attributes)}},{attributes:{value:Object.freeze(o)},converter:{value:Object.freeze(n)}})}({read:function(e){return'"'===e[0]&&(e=e.slice(1,-1)),e.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent)},write:function(e){return encodeURIComponent(e).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent)}},{path:"/"});return t}));

data/lib/pg_eventstore/web/subscriptions/helpers.rb

@@ -107,6 +107,18 @@ module PgEventstore
           encoded_params = Rack::Utils.build_nested_query(ids: ids)
           url("/delete_all_subscriptions?#{encoded_params}")
         end
+
+        # @param global_position [Integer]
+        # @return [String]
+        def delete_event_url(global_position)
+          url("/delete_event/#{global_position}")
+        end
+
+        # @param stream_attrs [Hash]
+        # @return [String]
+        def delete_stream_url(stream_attrs)
+          url("/delete_stream/#{stream_attrs[:context]}/#{stream_attrs[:stream_name]}/#{stream_attrs[:stream_id]}")
+        end
       end
     end
   end

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

@@ -165,3 +165,35 @@
     </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/home/partials/event_filter.erb

@@ -1,6 +1,6 @@
 <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') %>">
+    <select name="filter[events][]" class="form-control mb-2" data-placeholder="Event type" data-url="<%= url('/event_types_filtering') %>" autocomplete="off">
       <option></option>
       <% if event_type %>
         <option value="<%= h event_type %>" selected><%= h event_type %></option>

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

@@ -16,8 +16,14 @@
     </td>
     <td><%= event.created_at.strftime('%F %T') %></td>
     <td><%= event.id %></td>
-    <td><a href="javascript: void(0);" class="d-inline-block text-nowrap toggle-event-data">JSON <i
-      class="fa fa-eye"></i> </a></td>
+    <td>
+      <a href="javascript: void(0);" class="d-inline-block text-nowrap toggle-event-data">
+        JSON <i class="fa fa-eye"></i>
+      </a>
+      <a href="javascript: void(0);" class="ml-2 btn btn-danger btn-small delete-event-btn" data-global-position="<%= event.global_position %>" data-url="<%= delete_event_url(event.global_position) %>" data-toggle="modal" data-target="#delete-event-modal">
+        Delete
+      </a>
+    </td>
   </tr>
   <tr class="event-payload d-none">
     <td colspan="8">

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

@@ -1,31 +1,36 @@
 <div class="form-row align-items-center">
   <div class="col-3">
-    <select name="filter[streams][][context]" class="form-control mb-2" data-placeholder="Context" data-url="<%= url('/stream_contexts_filtering') %>">
+    <select name="filter[streams][][context]" class="form-control mb-2" data-placeholder="Context" data-url="<%= url('/stream_contexts_filtering') %>" autocomplete="off">
       <option></option>
       <% if stream[:context] %>
         <option value="<%= h stream[:context] %>" selected><%= h stream[:context] %></option>
       <% end %>
     </select>
   </div>
-  <div class="col-4">
-    <select name="filter[streams][][stream_name]" class="form-control mb-2" data-placeholder="Stream name" data-url="<%= url('/stream_names_filtering') %>">
+  <div class="col-3">
+    <select name="filter[streams][][stream_name]" class="form-control mb-2" data-placeholder="Stream name" data-url="<%= url('/stream_names_filtering') %>" autocomplete="off">
       <option></option>
       <% if stream[:stream_name] %>
         <option value="<%= h stream[:stream_name] %>" selected><%= h stream[:stream_name] %></option>
       <% end %>
     </select>
   </div>
-  <div class="col-4">
-    <select name="filter[streams][][stream_id]" class="form-control mb-2" data-placeholder="Stream ID" data-url="<%= url('/stream_ids_filtering') %>">
+  <div class="col-3">
+    <select name="filter[streams][][stream_id]" class="form-control mb-2" data-placeholder="Stream ID" data-url="<%= url('/stream_ids_filtering') %>" autocomplete="off">
       <option></option>
       <% if stream[:stream_id] %>
         <option value="<%= h stream[:stream_id] %>" selected><%= h stream[:stream_id] %></option>
       <% end %>
     </select>
   </div>
-  <div class="col-1">
+  <div class="col-3">
     <a class="btn btn-default remove-filter" href="javascript: void(0);">
       <i class="fa fa-minus-circle"></i>
     </a>
+    <% if stream[:context] && stream[:stream_name] && stream[:stream_id] %>
+      <a class="btn btn-danger btn-small delete-stream" data-confirm="You are about to delete all events in <%= h stream.inspect %> stream. This action is irreversible Continue?" data-confirm-title="Delete Stream" data-method="post" href="<%= delete_stream_url(stream) %>">
+        Delete stream
+      </a>
+    <% end %>
   </div>
 </div>

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

@@ -1,6 +1,6 @@
 <div class="form-row align-items-center">
   <div class="col-3">
-    <select name="filter[system_stream]" class="form-control mb-2" data-placeholder="Select system stream">
+    <select name="filter[system_stream]" class="form-control mb-2" data-placeholder="Select system stream" autocomplete="off">
       <option></option>
       <% PgEventstore::Stream::KNOWN_SYSTEM_STREAMS.each do |stream_name| %>
         <option value="<%= stream_name %>" <% if stream == stream_name %> selected <% end %>><%= stream_name %></option>

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

@@ -95,6 +95,12 @@
             </li>
           </ul>
         </nav>
+        <div class="alert alert-success alert-dismissible fade show text-center d-none" id="flash-message" role="alert">
+          <h5 class="text-dark message"></h5>
+          <button type="button" class="close" data-dismiss="alert" aria-label="Close">
+            <span aria-hidden="true">&times;</span>
+          </button>
+        </div>
       </div>
     </div>
     <!-- /top navigation -->
@@ -133,12 +139,18 @@
   </div>
 </div>
 
+<script type="text/javascript">
+  window.flashMessageCookie = "<%= PgEventstore::Web::Application::COOKIES_FLASH_MESSAGE_KEY %>";
+</script>
+
 <!-- jQuery -->
 <script src="<%= asset_url("javascripts/vendor/jquery.min.js") %>"></script>
 <!-- Bootstrap -->
 <script src="<%= asset_url("javascripts/vendor/bootstrap.bundle.min.js") %>"></script>
 <script src="<%= asset_url("javascripts/vendor/select2.full.min.js") %>"></script>
 
+<script src="<%= asset_url("javascripts/vendor/js.cookie.min.js") %>"></script>
+
 <!-- Custom Theme Scripts -->
 <script src="<%= asset_url("javascripts/gentelella.js") %>"></script>
 <script src="<%= asset_url("javascripts/pg_eventstore.js") %>"></script>

data/lib/pg_eventstore.rb

@@ -11,13 +11,19 @@ require_relative 'pg_eventstore/event_class_resolver'
 require_relative 'pg_eventstore/config'
 require_relative 'pg_eventstore/event'
 require_relative 'pg_eventstore/stream'
+require_relative 'pg_eventstore/commands'
+require_relative 'pg_eventstore/queries'
 require_relative 'pg_eventstore/client'
+require_relative 'pg_eventstore/maintenance'
 require_relative 'pg_eventstore/connection'
 require_relative 'pg_eventstore/errors'
 require_relative 'pg_eventstore/middleware'
 require_relative 'pg_eventstore/subscriptions/subscriptions_manager'
 
 module PgEventstore
+  # @return [Symbol]
+  DEFAULT_CONFIG = :default
+
   class << self
     # @!attribute mutex
     #   @return [Thread::Mutex]
@@ -27,7 +33,7 @@ module PgEventstore
     # 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)
+    def configure(name: DEFAULT_CONFIG)
       mutex.synchronize do
         @config[name] ||= Config.new(name: name)
         connection_config_was = @config[name].connection_options
@@ -48,7 +54,7 @@ module PgEventstore
 
     # @param name [Symbol]
     # @return [PgEventstore::Config]
-    def config(name = :default)
+    def config(name = DEFAULT_CONFIG)
       return @config[name] if @config[name]
 
       error_message = <<~TEXT
@@ -64,7 +70,7 @@ module PgEventstore
     # thread-safe
     # @param name [Symbol]
     # @return [PgEventstore::Connection]
-    def connection(name = :default)
+    def connection(name = DEFAULT_CONFIG)
       mutex.synchronize do
         @connection[name] ||= Connection.new(**config(name).connection_options)
       end
@@ -76,7 +82,7 @@ module PgEventstore
     # @param retries_interval [Integer, nil] a delay between retries of failed SubscriptionsSet
     # @param force_lock [Boolean] whether to force-lock subscriptions
     # @return [PgEventstore::SubscriptionsManager]
-    def subscriptions_manager(config_name = :default, subscription_set:, max_retries: nil, retries_interval: nil,
+    def subscriptions_manager(config_name = DEFAULT_CONFIG, subscription_set:, max_retries: nil, retries_interval: nil,
                               force_lock: false)
       SubscriptionsManager.new(
         config: config(config_name),
@@ -89,10 +95,16 @@ module PgEventstore
 
     # @param name [Symbol]
     # @return [PgEventstore::Client]
-    def client(name = :default)
+    def client(name = DEFAULT_CONFIG)
       Client.new(config(name))
     end
 
+    # @param name [Symbol]
+    # @return [PgEventstore::Maintenance]
+    def maintenance(name = DEFAULT_CONFIG)
+      Maintenance.new(config(name))
+    end
+
     # @return [Logger, nil]
     def logger
       @logger
@@ -108,7 +120,7 @@ module PgEventstore
 
     # @return [void]
     def init_variables
-      @config = { default: Config.new(name: :default) }
+      @config = { DEFAULT_CONFIG => Config.new(name: DEFAULT_CONFIG) }
       @connection = {}
       @mutex = Thread::Mutex.new
     end

data/sig/pg_eventstore/commands/delete_event.rbs

@@ -0,0 +1,13 @@
+module PgEventstore
+  module Commands
+    class DeleteEvent
+      MAX_RECORDS_TO_LOCK: Integer
+
+      def call: (PgEventstore::Event event, force: bool)-> bool
+
+      private
+
+      def check_records_number_to_lock: (PgEventstore::Event event)-> void
+    end
+  end
+end

data/sig/pg_eventstore/commands/delete_stream.rbs

@@ -0,0 +1,7 @@
+module PgEventstore
+  module Commands
+    class DeleteStream < PgEventstore::AbstractCommand
+      def call: (PgEventstore::Stream stream) -> bool
+    end
+  end
+end

data/sig/pg_eventstore/errors.rbs

@@ -113,4 +113,14 @@ module PgEventstore
 
     attr_accessor event_types: ::Array[String]
   end
+
+  class TooManyRecordsToLockError < PgEventstore::Error
+    def initialize: (PgEventstore::Stream stream, Integer number_of_records) -> void
+
+    attr_accessor stream: PgEventstore::Stream
+
+    attr_accessor number_of_records: Integer
+
+    def user_friendly_message: -> String
+  end
 end

data/sig/pg_eventstore/maintenance.rbs

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

data/sig/pg_eventstore/queries/maintenance_queries.rbs

@@ -0,0 +1,21 @@
+module PgEventstore
+  class MaintenanceQueries
+    attr_reader connection: PgEventstore::Connection
+
+    def initialize: (PgEventstore::Connection connection)-> untyped
+
+    def adjust_stream_revisions: (PgEventstore::Stream stream, Integer after_revision)-> void
+
+    def delete_event: (PgEventstore::Event event)-> Integer
+
+    def delete_stream: (PgEventstore::Stream stream)-> Integer
+
+    def events_to_lock_count: (PgEventstore::Stream stream, Integer after_revision)-> Integer
+
+    def reload_event: (PgEventstore::Event event)-> PgEventstore::Event?
+
+    private
+
+    def basic_deserializer: -> PgEventstore::EventDeserializer
+  end
+end

data/sig/pg_eventstore/queries.rbs

@@ -2,6 +2,14 @@ module PgEventstore
   class Queries
     include PgEventstore::Extensions::OptionsExtension
 
+    attr_accessor events: PgEventstore::EventQueries?
+
+    attr_accessor partitions: PgEventstore::PartitionQueries?
+
+    attr_accessor transactions: PgEventstore::TransactionQueries?
+
+    attr_accessor maintenance: PgEventstore::MaintenanceQueries?
+
     def initialize: (**untyped options) -> void
 
     def options_hash: () -> ::Hash[untyped, untyped]
@@ -13,11 +21,5 @@ module PgEventstore
     def readonly_error: (Symbol opt_name) -> void
 
     def init_default_values: (::Hash[untyped, untyped] options) -> void
-
-    attr_accessor events: PgEventstore::EventQueries?
-
-    attr_accessor partitions: PgEventstore::PartitionQueries?
-
-    attr_accessor transactions: PgEventstore::TransactionQueries?
   end
 end

data/sig/pg_eventstore/web/application.rbs

@@ -1,6 +1,10 @@
 module PgEventstore
   module Web
     class Application
+      COOKIES_CONFIG_KEY: String
+      COOKIES_FLASH_MESSAGE_KEY: String
+      DEFAULT_ADMIN_UI_CONFIG: Symbol
+
       def asset_url: (String path) -> String
 
       def connection: -> PgEventstore::Connection
@@ -11,12 +15,16 @@ module PgEventstore
 
       def events_filter: -> Array[String]?
 
+      def flash_message=: (({ message: String, kind: String }) val)-> String
+
       def h: (String text) -> String
 
       def paginated_json_response: (PgEventstore::Web::Paginator::BaseCollection collection) -> void
 
       def redirect_back_url: (fallback_url: String) -> String
 
+      def resolve_config_by_name: (Symbol? config_name)-> Symbol
+
       def resolve_link_tos?: -> bool
 
       def streams_filter: -> Array[Hash[untyped, untyped]]?

data/sig/pg_eventstore/web/subscriptions/helpers.rbs

@@ -2,6 +2,10 @@ module PgEventstore
   module Web
     module Subscriptions
       module Helpers
+        def delete_event_url: (Integer global_position)-> String
+
+        def delete_stream_url: (({ context: String, stream_name: String, stream_id: String }) stream_attrs)-> String
+
         # _@param_ `set_name`
         def subscriptions_url: (?set_name: String?) -> String
 

data/sig/pg_eventstore.rbs

@@ -1,4 +1,6 @@
 module PgEventstore
+  DEFAULT_CONFIG: Symbol
+
   # _@param_ `name` — a name to assign to a config
   #
   # _@return_ — a result of the given block
@@ -12,6 +14,8 @@ module PgEventstore
   # _@param_ `name`
   def self.connection: (?Symbol name) -> PgEventstore::Connection
 
+  def self.maintenance: (?Symbol name) -> PgEventstore::Maintenance
+
   def self.subscriptions_manager: (
       ?Symbol config_name,
       subscription_set: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pg_eventstore
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Ivan Dzyzenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-01-10 00:00:00.000000000 Z
+date: 2025-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
@@ -78,12 +78,14 @@ files:
 - db/migrations/5_partitions.sql
 - db/migrations/6_add_commands_data.sql
 - db/migrations/7_support_reading_streams_system_stream.sql
+- db/migrations/8_improve_0_revision_partial_index.sql
 - docs/admin_ui.md
 - docs/appending_events.md
 - docs/configuration.md
 - docs/events_and_streams.md
 - docs/how_it_works.md
 - docs/linking_events.md
+- docs/maintenance.md
 - docs/multiple_commands.md
 - docs/reading_events.md
 - docs/subscriptions.md
@@ -115,6 +117,8 @@ files:
 - lib/pg_eventstore/client.rb
 - lib/pg_eventstore/commands.rb
 - lib/pg_eventstore/commands/append.rb
+- lib/pg_eventstore/commands/delete_event.rb
+- lib/pg_eventstore/commands/delete_stream.rb
 - lib/pg_eventstore/commands/event_modifiers/prepare_link_event.rb
 - lib/pg_eventstore/commands/event_modifiers/prepare_regular_event.rb
 - lib/pg_eventstore/commands/link_to.rb
@@ -133,11 +137,13 @@ files:
 - lib/pg_eventstore/extensions/callbacks_extension.rb
 - lib/pg_eventstore/extensions/options_extension.rb
 - lib/pg_eventstore/extensions/using_connection_extension.rb
+- lib/pg_eventstore/maintenance.rb
 - lib/pg_eventstore/middleware.rb
 - lib/pg_eventstore/pg_connection.rb
 - lib/pg_eventstore/queries.rb
 - lib/pg_eventstore/queries/event_queries.rb
 - lib/pg_eventstore/queries/links_resolver.rb
+- 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/events_filtering.rb
@@ -207,6 +213,7 @@ files:
 - lib/pg_eventstore/web/public/javascripts/vendor/bootstrap.bundle.min.js
 - lib/pg_eventstore/web/public/javascripts/vendor/jquery.autocomplete.min.js
 - lib/pg_eventstore/web/public/javascripts/vendor/jquery.min.js
+- lib/pg_eventstore/web/public/javascripts/vendor/js.cookie.min.js
 - lib/pg_eventstore/web/public/javascripts/vendor/select2.full.min.js
 - lib/pg_eventstore/web/public/stylesheets/pg_eventstore.css
 - lib/pg_eventstore/web/public/stylesheets/vendor/bootstrap.min.css
@@ -265,6 +272,8 @@ files:
 - sig/pg_eventstore/cli/wait_for_subscriptions_set_shutdown.rbs
 - sig/pg_eventstore/client.rbs
 - sig/pg_eventstore/commands/append.rbs
+- sig/pg_eventstore/commands/delete_event.rbs
+- sig/pg_eventstore/commands/delete_stream.rbs
 - sig/pg_eventstore/commands/event_modifiers/prepare_link_event.rbs
 - sig/pg_eventstore/commands/event_modifiers/prepare_regular_event.rbs
 - sig/pg_eventstore/commands/link_to.rbs
@@ -283,11 +292,13 @@ files:
 - sig/pg_eventstore/extensions/callbacks_extension.rbs
 - sig/pg_eventstore/extensions/options_extension.rbs
 - sig/pg_eventstore/extensions/using_connection_extension.rbs
+- sig/pg_eventstore/maintenance.rbs
 - sig/pg_eventstore/middleware.rbs
 - sig/pg_eventstore/pg_connection.rbs
 - sig/pg_eventstore/queries.rbs
 - sig/pg_eventstore/queries/event_queries.rbs
 - sig/pg_eventstore/queries/links_resolver.rbs
+- 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/events_filtering_query.rbs