pg_eventstore 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac379ed7a4c1c8ca46edd8e4ec537dafd575dd50749a140d15c49c24a1ece1c1
-  data.tar.gz: c5f83c5aa8fccc6f7100172270c951fda96ca7926c7a1b6b37f90217024e3e09
+  metadata.gz: 7c0936a5580f6340a43f65d5b1b3362855b30e78fb25bdd498bf21c759458fcb
+  data.tar.gz: d18a05c7c6917e66c83de05013afcf6b9f25aaf7027e32fb1345553f5398a120
 SHA512:
-  metadata.gz: 6ffbe0ddbfff6207069a527c7f41693e59d00a3217f68697c851fb2582300fefc569be8035f30924a225b95522ee5ef29ec26c9c6134fe705b31f6b32d0c39a3
-  data.tar.gz: 3b1860f5f351f5ffcd56f09c557661796a98f46a49c9a9bf8945667074ad8705f7cb9998639031fe07a4a2dfb89a0bf636b1e8157a21374da869cf4e76377792
+  metadata.gz: b11fcbc08f2853a69c288dcd08498a5e40277cdeaf32ccba71ade48eac03cf3fd0c157abe0058daedb27aca945406afa8f3078f149e045ff63d89a47ca12da36
+  data.tar.gz: c021e192cfd8f61364235fa7ccdd2d97a37c39fe304f9167fe7cda508acd7c65b84bc2d168687a1cec185cf07870183b70fc849508a434ea13935398687cbea4

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [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

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/version.rb

@@ -2,5 +2,5 @@
 
 module PgEventstore
   # @return [String]
-  VERSION = "1.8.0"
+  VERSION = "1.9.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,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/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,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/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,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

@@ -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.9.0
 platform: ruby
 authors:
 - Ivan Dzyzenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-02-14 00:00:00.000000000 Z
+date: 2025-03-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