rails_simple_event_sourcing 1.0.6 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f612b51a40ff345ec42bb1fbc1aa60f7444278e4d7e8adca318fbf9ae3d6676e
-  data.tar.gz: 4e62dd3f13548750d95309e729537e1681c2630f05a901702d2e4afe96f48971
+  metadata.gz: 3de0a8a9ff2169679636b2f07ecbeb3c665bfd6a7167f564029c343d508dbcc0
+  data.tar.gz: 136e1bb962428462dd0921cefa63746beefb6efab578f6c8a0e018709f10da1f
 SHA512:
-  metadata.gz: fbd0a8385be3282c59d0c29908b65eb209f82a4a6978e9f614f72de8ebe5ed06b1c88daa4e6975cab94e3c5f4e9e9e3b00d8c977d7c46f64642e2c7eadde2c8e
-  data.tar.gz: e2552009f821e2e71e0c72f274c5dd1056465c1f1cc991100320f08152be6db7df4f874e83439ad29408779cac02877b851e9ebb5204b6be6f03da76ada8d03c
+  metadata.gz: fcd653bc3201aeb4cffca05df6f9819e3b8d9ee2eab08e60e35988438321bf6f6b15fb7d65d0940483f9087877f5f451645fc26f7e1fb31fb36e61a898760aee
+  data.tar.gz: 85449f552f258d5d2ccd43f238389769dafdf885d93beeb7f1e4f47280f1bbc9ab5acb8fa435e94a3ca9f0602af52677812f1c8dcffa85857277b977081f0fb7

data/README.md

@@ -88,6 +88,9 @@ RailsSimpleEventSourcing.configure do |config|
   # When true, falls back to convention-based handler resolution
   # When false, requires explicit registration of all handlers
   config.use_naming_convention_fallback = true
+
+  # Number of events displayed per page in the Events Viewer (defaults to 25)
+  config.events_per_page = 50
 end
 ```
 
@@ -545,11 +548,11 @@ Mount the engine in your `config/routes.rb`:
 
 ```ruby
 Rails.application.routes.draw do
-  mount RailsSimpleEventSourcing::Engine, at: "/event-store"
+  mount RailsSimpleEventSourcing::Engine, at: "/events"
 end
 ```
 
-Then navigate to `/event-store` in your browser to access the viewer.
+Then navigate to `/events` in your browser to access the viewer.
 
 **Password Protection:**
 
@@ -561,11 +564,11 @@ In production you will likely want to restrict access to the events viewer.
 Rails.application.routes.draw do
   mount Rack::Auth::Basic.new(
     RailsSimpleEventSourcing::Engine,
-    "Event Sourcing"
+    "Events"
   ) { |username, password|
     ActiveSupport::SecurityUtils.secure_compare(username, "admin") &
     ActiveSupport::SecurityUtils.secure_compare(password, Rails.application.credentials.event_sourcing_password || "secret")
-  }, at: "/event-sourcing"
+  }, at: "/events"
 end
 ```
 
@@ -574,7 +577,7 @@ end
 ```ruby
 Rails.application.routes.draw do
   authenticate :user, ->(user) { user.admin? } do
-    mount RailsSimpleEventSourcing::Engine, at: "/event-store"
+    mount RailsSimpleEventSourcing::Engine, at: "/events"
   end
 end
 ```
@@ -587,16 +590,6 @@ end
 - **Filtering** - Filter events by event type or aggregate type using dropdown selectors
 - **Search** - Search by aggregate ID, or use `key:value` syntax to search within payload and metadata (e.g., `email:john@example.com`)
 
-**Configuration:**
-
-You can configure the number of events displayed per page (defaults to 25):
-
-```ruby
-RailsSimpleEventSourcing.configure do |config|
-  config.events_per_page = 50
-end
-```
-
 ### Model Configuration
 
 Models that use event sourcing should include the `RailsSimpleEventSourcing::Events` module:
@@ -646,10 +639,6 @@ class Customer < ApplicationRecord
 
   scope :active, -> { where(deleted_at: nil) }
   scope :deleted, -> { where.not(deleted_at: nil) }
-
-  def soft_delete
-    update(deleted_at: Time.current)
-  end
 end
 
 # Event

data/app/controllers/rails_simple_event_sourcing/events_controller.rb

@@ -3,9 +3,9 @@
 module RailsSimpleEventSourcing
   class EventsController < ApplicationController
     def index
-      load_filter_options
-      scope = search_events
-      paginate(scope)
+      @event_types = event_types
+      @aggregates = aggregates
+      paginate(search_events)
     end
 
     def show
@@ -16,15 +16,21 @@ module RailsSimpleEventSourcing
 
     private
 
-    def load_filter_options
-      @event_types = Event.distinct.pluck(:event_type).sort
-      @aggregates = Event.where.not(eventable_type: nil).distinct.pluck(:eventable_type).sort
+    def event_types
+      return Event.descendants.map(&:name).sort if Rails.env.production?
+
+      Event.distinct.pluck(:event_type).sort
+    end
+
+    def aggregates
+      return Event.descendants.filter_map(&:aggregate_class).map(&:name).uniq.sort if Rails.env.production?
+
+      Event.where.not(eventable_type: nil).distinct.pluck(:eventable_type).sort
     end
 
     def search_events
-      scope = Event.order(created_at: :desc)
       EventSearch.new(
-        scope:,
+        scope: Event.all,
         event_type: params[:event_type],
         aggregate: params[:aggregate],
         query: params[:q]
@@ -34,8 +40,9 @@ module RailsSimpleEventSourcing
     def paginate(scope)
       @paginator = Paginator.new(
         scope:,
-        page: params[:page],
-        per_page: RailsSimpleEventSourcing.config.events_per_page
+        per_page: RailsSimpleEventSourcing.config.events_per_page,
+        cursor: params[:after] || params[:before],
+        direction: params[:before].present? ? :prev : :next
       )
     end
 

data/app/helpers/rails_simple_event_sourcing/events_helper.rb

@@ -2,26 +2,5 @@
 
 module RailsSimpleEventSourcing
   module EventsHelper
-    def pagination_window(current_page, total_pages, window: 2) # rubocop:disable Metrics/MethodLength
-      return [1] if total_pages <= 1
-
-      pages = []
-      left = [current_page - window, 1].max
-      right = [current_page + window, total_pages].min
-
-      if left > 1
-        pages << 1
-        pages << :gap if left > 2
-      end
-
-      (left..right).each { |p| pages << p }
-
-      if right < total_pages
-        pages << :gap if right < total_pages - 1
-        pages << total_pages
-      end
-
-      pages
-    end
   end
 end

data/app/models/concerns/rails_simple_event_sourcing/read_only.rb

@@ -13,6 +13,10 @@ module RailsSimpleEventSourcing
         @write_access_enabled = true
       end
 
+      def disable_write_access!
+        @write_access_enabled = false
+      end
+
       private
 
       def write_access_enabled

data/app/models/rails_simple_event_sourcing/event.rb

@@ -14,10 +14,13 @@ module RailsSimpleEventSourcing
 
     before_validation :setup_for_create, on: :create
     before_save :persist_aggregate, if: :aggregate_defined?
+    after_create :disable_write_access!
 
     def apply(aggregate)
       payload.each do |key, value|
-        aggregate.send("#{key}=", value) if aggregate.respond_to?("#{key}=")
+        raise "Unknown attribute '#{key}' on #{aggregate.class}" unless aggregate.respond_to?("#{key}=")
+
+        aggregate.send("#{key}=", value)
       end
     end
 
@@ -67,6 +70,7 @@ module RailsSimpleEventSourcing
 
       aggregate_repository.save!(@aggregate)
       self.aggregate_id = @aggregate.id
+      @aggregate.disable_write_access!
     end
 
     def aggregate_repository

data/app/views/rails_simple_event_sourcing/events/_pagination.html.erb

@@ -1,23 +1,13 @@
-<% if @paginator.total_pages > 1 %>
+<% if @paginator.prev? || @paginator.next? %>
   <nav class="pagination">
-    <% if @paginator.current_page > 1 %>
-      <%= link_to "Prev", events_path(page: @paginator.current_page - 1, q: params[:q], event_type: params[:event_type], aggregate: params[:aggregate]) %>
+    <% if @paginator.prev? %>
+      <%= link_to "Prev", events_path(before: @paginator.prev_cursor, q: params[:q], event_type: params[:event_type], aggregate: params[:aggregate]) %>
     <% else %>
       <span class="disabled">Prev</span>
     <% end %>
 
-    <% pagination_window(@paginator.current_page, @paginator.total_pages).each do |page| %>
-      <% if page == :gap %>
-        <span class="gap">&hellip;</span>
-      <% elsif page == @paginator.current_page %>
-        <span class="current"><%= page %></span>
-      <% else %>
-        <%= link_to page, events_path(page: page, q: params[:q], event_type: params[:event_type], aggregate: params[:aggregate]) %>
-      <% end %>
-    <% end %>
-
-    <% if @paginator.current_page < @paginator.total_pages %>
-      <%= link_to "Next", events_path(page: @paginator.current_page + 1, q: params[:q], event_type: params[:event_type], aggregate: params[:aggregate]) %>
+    <% if @paginator.next? %>
+      <%= link_to "Next", events_path(after: @paginator.next_cursor, q: params[:q], event_type: params[:event_type], aggregate: params[:aggregate]) %>
     <% else %>
       <span class="disabled">Next</span>
     <% end %>

data/app/views/rails_simple_event_sourcing/events/index.html.erb

@@ -10,8 +10,7 @@
 
 <div class="card">
   <div class="info-bar">
-    <span><%= @paginator.total_count %> event<%= @paginator.total_count == 1 ? "" : "s" %> found</span>
-    <span>Page <%= @paginator.current_page %> of <%= @paginator.total_pages %></span>
+    <span>Events</span>
   </div>
 
   <table>

data/app/views/rails_simple_event_sourcing/events/show.html.erb

@@ -1,4 +1,4 @@
-<%= link_to "&larr; Back to events".html_safe, events_path(q: params[:q], page: params[:page]), class: "back-link" %>
+<%= link_to "&larr; Back to events".html_safe, events_path(q: params[:q]), class: "back-link" %>
 
 <div class="card">
   <dl class="detail-grid">

data/config/routes.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 RailsSimpleEventSourcing::Engine.routes.draw do
-  resources :events, only: [:index, :show]
-  root to: "events#index"
+  root to: "events#index", as: :events
+  get ":id", to: "events#show", as: :event
 end

data/lib/rails_simple_event_sourcing/engine.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'concurrent'
 require_relative 'aggregate_repository'
 require_relative 'command_handler'
 require_relative 'command_handlers/base'

data/lib/rails_simple_event_sourcing/paginator.rb

@@ -2,18 +2,68 @@
 
 module RailsSimpleEventSourcing
   class Paginator
-    attr_reader :total_count, :total_pages, :current_page, :per_page
+    attr_reader :per_page
 
-    def initialize(scope:, page:, per_page:)
+    def initialize(scope:, per_page:, cursor: nil, direction: :next)
       @scope = scope
       @per_page = per_page
-      @total_count = scope.count
-      @total_pages = [(@total_count.to_f / per_page).ceil, 1].max
-      @current_page = (page.presence || 1).to_i.clamp(1, @total_pages)
+      @cursor = cursor&.to_i
+      @direction = direction
     end
 
     def records
-      @scope.offset((@current_page - 1) * @per_page).limit(@per_page)
+      @records ||= fetch_records
+    end
+
+    def next_cursor
+      records.last&.id
+    end
+
+    def prev_cursor
+      records.first&.id
+    end
+
+    def next?
+      records
+      @has_next
+    end
+
+    def prev?
+      records
+      @has_prev
+    end
+
+    private
+
+    def fetch_records
+      if @cursor.nil?
+        fetch_first_page
+      elsif @direction == :prev
+        fetch_prev_page
+      else
+        fetch_next_page
+      end
+    end
+
+    def fetch_first_page
+      rows = @scope.order(id: :desc).limit(@per_page + 1).to_a
+      @has_prev = false
+      @has_next = rows.size > @per_page
+      rows.first(@per_page)
+    end
+
+    def fetch_next_page
+      rows = @scope.where(id: ...@cursor).order(id: :desc).limit(@per_page + 1).to_a
+      @has_prev = true
+      @has_next = rows.size > @per_page
+      rows.first(@per_page)
+    end
+
+    def fetch_prev_page
+      rows = @scope.where('id > ?', @cursor).order(id: :asc).limit(@per_page + 1).to_a
+      @has_next = true
+      @has_prev = rows.size > @per_page
+      rows.first(@per_page).reverse
     end
   end
 end

data/lib/rails_simple_event_sourcing/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsSimpleEventSourcing
-  VERSION = '1.0.6'
+  VERSION = '1.0.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_simple_event_sourcing
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.8
 platform: ruby
 authors:
 - Damian Baćkowski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-15 00:00:00.000000000 Z
+date: 2026-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 7.1.2
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement