pg_eventstore 1.8.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac379ed7a4c1c8ca46edd8e4ec537dafd575dd50749a140d15c49c24a1ece1c1
-  data.tar.gz: c5f83c5aa8fccc6f7100172270c951fda96ca7926c7a1b6b37f90217024e3e09
+  metadata.gz: c3ff0f3d0cf7c80ebe381ca1da32b921766c10055832f05b94d15e2f25b73d55
+  data.tar.gz: a00e2ef1bc9435b2e5b7732e0dd5ee85a3a3ed6e457c5d106f654f035ff7c3e3
 SHA512:
-  metadata.gz: 6ffbe0ddbfff6207069a527c7f41693e59d00a3217f68697c851fb2582300fefc569be8035f30924a225b95522ee5ef29ec26c9c6134fe705b31f6b32d0c39a3
-  data.tar.gz: 3b1860f5f351f5ffcd56f09c557661796a98f46a49c9a9bf8945667074ad8705f7cb9998639031fe07a4a2dfb89a0bf636b1e8157a21374da869cf4e76377792
+  metadata.gz: 23c6bd66a79199cf49411e73635d4829c5bef802a97c3e37f3d46513a1c7b8163163fa665b99d47bd870829ba2059650c4d8b9798c95991c37834e478b352aa4
+  data.tar.gz: af188405be2d0a13c8694840dc6dcb5eef435ada27979a2f570be1ccacf33c465930d4bb9237ad6d7c78c7bde2edc5d0cfa61064dd7dc8c2c0c6a11856f39980

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [1.10.0]
+- Admin UI: Adjust `SubscriptionSet` "Stop"/"Delete" buttons appearance. Now if `SubscriptionsSet` is not alive anymore(the related process is dead or does not exist anymore) - "Delete" button is shown. If `SubscriptionSet` is alive - "Stop" button is shown
+- Admin IU: fixed several potential XSS vulnerabilities
+- Admin IU: Add "Copy to clipboard" button near stream id that copies ruby stream definition
+- Admin UI: allow deletion of streams with empty attribute values
+
+## [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

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/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/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/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/subscriptions/subscription.rb

@@ -6,6 +6,9 @@ module PgEventstore
     include Extensions::UsingConnectionExtension
     include Extensions::OptionsExtension
 
+    # @return [Time]
+    DEFAULT_TIMESTAMP = Time.at(0).utc.freeze
+
     # @!attribute id
     #   @return [Integer, nil]
     attribute(:id)
@@ -164,7 +167,7 @@ module PgEventstore
         last_restarted_at: nil,
         max_restarts_number: max_restarts_number,
         chunk_query_interval: chunk_query_interval,
-        last_chunk_fed_at: Time.at(0).utc,
+        last_chunk_fed_at: DEFAULT_TIMESTAMP,
         last_chunk_greatest_position: nil,
         last_error: nil,
         last_error_occurred_at: nil,

data/lib/pg_eventstore/version.rb

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

data/lib/pg_eventstore/web/application.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'securerandom'
+require 'base64'
 
 module PgEventstore
   module Web
@@ -9,6 +10,8 @@ module PgEventstore
       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 }
@@ -97,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
@@ -243,6 +254,65 @@ 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' do
+        attrs = {
+          context: params[:context]&.to_s,
+          stream_name: params[:stream_name]&.to_s,
+          stream_id: params[:stream_id]&.to_s,
+        }
+
+        err_message = ->(attrs) {
+          self.flash_message = {
+            message: "Could not delete #{attrs}. It is not valid stream for deletion.",
+            kind: 'error'
+          }
+        }
+
+        if attrs.values.none?(&:nil?)
+          stream = PgEventstore::Stream.new(**attrs)
+          if stream.system?
+            err_message.call(stream.to_hash)
+          else
+            PgEventstore.maintenance(current_config).delete_stream(stream)
+            self.flash_message = {
+              message: "Stream #{stream.to_hash} has been successfully deleted.",
+              kind: 'success'
+            }
+          end
+        else
+          err_message.call(attrs)
+        end
+
+        redirect(redirect_back_url(fallback_url: '/'))
+      end
     end
   end
 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){
@@ -188,14 +196,14 @@ $(function(){
     let $confirmationModal = $('#confirmation-modal');
 
     $confirmationModal.on('hide.bs.modal', function(){
-        $(this).find('.modal-title').html('');
-        $(this).find('.modal-body').html('');
+        $(this).find('.modal-title').text('');
+        $(this).find('.modal-body').text('');
         $(this).find('.confirm').off();
     });
     let showConfirmation = function(el, callback){
         let $el = $(el);
-        $confirmationModal.find('.modal-body').html($el.data('confirm'));
-        $confirmationModal.find('.modal-title').html($el.data('confirm-title'));
+        $confirmationModal.find('.modal-body').text($el.data('confirm'));
+        $confirmationModal.find('.modal-title').text($el.data('confirm-title'));
         $confirmationModal.modal('show');
         $confirmationModal.one('click', '.confirm', callback);
     }
@@ -257,3 +265,90 @@ $(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);
+});
+
+// Copy to clipboard with a tooltip implementation
+$(function () {
+    "use strict";
+
+    let $selector = $(".copy-to-clipboard");
+
+    $selector.tooltip({
+        container: "body",
+        title: function(){
+            let $this = $(this);
+
+            return $this.data("temp-title") || $this.data("title");
+        }
+    });
+
+    $selector.click(function () {
+        let $this = $(this);
+
+        navigator.clipboard.writeText($this.data("clipboard-content"));
+
+        $this.data("temp-title", "Copied!");
+        $this.data("bs.tooltip").hide();
+        $this.one("shown.bs.tooltip", function(){
+            $this.data("temp-title", null);
+        });
+        $this.data("bs.tooltip").show();
+    });
+});

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

@@ -79,34 +79,60 @@ module PgEventstore
         # @param updated_at [Time]
         # @return [String] html status
         def colored_state(state, interval, updated_at)
-          if state == RunnerState::STATES[:running]
-            # -1 is added as a margin to prevent false-positive result
-            if updated_at < Time.now.utc - interval - 1
-              title = <<~TEXT
-                Something is wrong. Last update was more than #{interval} seconds ago(#{updated_at}).
-              TEXT
-              <<~HTML
-                <span class="text-warning text-nowrap">
-                  #{state}
-                  <i class="fa fa-question-circle" data-toggle="tooltip" title="#{title}"></i>
-                </span>              
-              HTML
+          text_class =
+            case state
+            when RunnerState::STATES[:running]
+              alive?(interval, updated_at) ? 'text-success' : 'text-warning'
+            when RunnerState::STATES[:dead]
+              'text-danger'
             else
-              "<span class=\"text-success\">#{state}</span>"
+              'text-info'
             end
-          elsif state == RunnerState::STATES[:dead]
-            "<span class=\"text-danger\">#{state}</span>"
+
+          if alive?(interval, updated_at)
+            <<~HTML
+              <span class="#{text_class}">#{state}</span>
+            HTML
           else
-            "<span class=\"text-info\">#{state}</span>"
+            title = <<~TEXT
+              Something is wrong. Last update was more than #{interval} seconds ago(#{updated_at}).
+            TEXT
+            <<~HTML
+              <span class="#{text_class} text-nowrap">
+                #{state}
+                <i class="fa fa-question-circle" data-toggle="tooltip" title="#{title}"></i>
+              </span>
+            HTML
           end
         end
 
+        # @param interval [Integer]
+        # @param last_updated_at [Time]
+        # @return [Boolean]
+        def alive?(interval, last_updated_at)
+          # -1 is added as a margin to prevent false-positive result
+          last_updated_at > Time.now.utc - interval - 1
+        end
+
         # @param ids [Array<Integer>]
         # @return [String]
         def delete_all_subscriptions_url(ids)
           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)
+          encoded_params = Rack::Utils.build_nested_query(stream_attrs)
+          url("/delete_stream?#{encoded_params}")
+        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

@@ -4,7 +4,13 @@
     <td><%= event.stream_revision %></td>
     <td><%= h event.stream.context %></td>
     <td><%= h event.stream.stream_name %></td>
-    <td><a href="<%= stream_path(event) %>"><%= event.stream.stream_id %></a></td>
+    <td>
+      <a href="<%= stream_path(event) %>"><%= 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>
+      </a>
+    </td>
     <td>
       <p class="float-left"><%= h event.type %></p>
       <% if event.link %>
@@ -16,8 +22,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/web/views/subscriptions/index.erb

@@ -85,14 +85,16 @@
                                   Restore
                                 </a>
                               <% end %>
-                              <% if PgEventstore::RunnerState::STATES.values_at(:running, :dead).include?(subscriptions_set.state) %>
+                              <% if PgEventstore::RunnerState::STATES.values_at(:running, :dead).include?(subscriptions_set.state) && alive?(PgEventstore::SubscriptionsSetLifecycle::HEARTBEAT_INTERVAL, subscriptions_set.updated_at) %>
                                 <a class="btn btn-warning" data-confirm="You are about to stop SubscriptionsSet#<%= subscriptions_set.id %>. This will also delete it and will result in stopping all related Subscriptions. If you used pg_eventstore CLI to start subscriptions - the related process will also be stopped.  Continue?" data-confirm-title="Stop SubscriptionsSet" data-method="post" href="<%= subscriptions_set_cmd_url(subscriptions_set.id, subscriptions_set_cmd('Stop')) %>" data-toggle="tooltip" title="This action will delete Subscriptions Set and release all related Subscriptions.">
                                   Stop
                                 </a>
                               <% end %>
-                              <a class="btn btn-danger" data-confirm="You are about to delete SubscriptionsSet#<%= subscriptions_set.id %>. Continue?" data-confirm-title="Delete SubscriptionsSet" data-method="post" href="<%= url("/delete_subscriptions_set/#{subscriptions_set.id}") %>" data-toggle="tooltip" title="Use this action only on stuck Subscriptions Set - to clean it up.">
-                                Delete
-                              </a>
+                              <% unless alive?(PgEventstore::SubscriptionsSetLifecycle::HEARTBEAT_INTERVAL, subscriptions_set.updated_at) %>
+                                <a class="btn btn-danger" data-confirm="You are about to delete SubscriptionsSet#<%= subscriptions_set.id %>. Continue?" data-confirm-title="Delete SubscriptionsSet" data-method="post" href="<%= url("/delete_subscriptions_set/#{subscriptions_set.id}") %>" data-toggle="tooltip" title="Use this action only on stuck Subscriptions Set - to clean it up.">
+                                  Delete
+                                </a>
+                              <% end %>
                             </td>
                           </tr>
                           <% if subscriptions_set.last_error %>
@@ -160,7 +162,7 @@
                             </td>
                             <td><%= subscription.current_position %></td>
                             <td><%= subscription.chunk_query_interval %>s</td>
-                            <td><%= subscription.last_chunk_fed_at %></td>
+                            <td><%= subscription.last_chunk_fed_at if subscription.last_chunk_fed_at > PgEventstore::Subscription::DEFAULT_TIMESTAMP %></td>
                             <td><%= colored_state(subscription.state, PgEventstore::SubscriptionsLifecycle::HEARTBEAT_INTERVAL, subscription.updated_at) %></td>
                             <td>
                               <% if subscription.average_event_processing_time %>

data/lib/pg_eventstore.rb

@@ -11,7 +11,10 @@ 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'
@@ -96,6 +99,12 @@ module PgEventstore
       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

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/subscriptions/subscription.rbs

@@ -1,5 +1,7 @@
 module PgEventstore
   class Subscription
+    DEFAULT_TIMESTAMP: Time
+
     include PgEventstore::Extensions::UsingConnectionExtension
     include PgEventstore::Extensions::OptionsExtension
 

data/sig/pg_eventstore/web/application.rbs

@@ -2,6 +2,7 @@ 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
@@ -14,6 +15,8 @@ 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

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

@@ -2,6 +2,12 @@ module PgEventstore
   module Web
     module Subscriptions
       module Helpers
+        def alive?: (Integer interval, Time last_updated_at)-> bool
+
+        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

@@ -14,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.8.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Ivan Dzyzenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-02-14 00:00:00.000000000 Z
+date: 2025-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
@@ -85,6 +85,7 @@ files:
 - 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
@@ -116,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
@@ -134,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
@@ -208,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
@@ -266,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
@@ -284,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