wal 0.0.14 → 0.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a10c111df779be284d3a1e20dac362c574d0abed4483d86479ad716c39c868dd
-  data.tar.gz: 18763673175466a85adef9b3d91eb6a188bfc2db1b8cd178678757b81a912eb1
+  metadata.gz: 14c30e66cc9c1425cb894a9cfb558941017659cf4f0ad5a2183782c25df4a5b4
+  data.tar.gz: 7704871035cecbb90ee47cbefff50ad2fe58b4515f7d2c0d439e40adf31bf3f4
 SHA512:
-  metadata.gz: 762f7c704d2a0dceafd9c1094e1413dbe272b7c71d676a49bcbc652d0d5266e91de357f8dd44cd5b4e26b8ec0ba2bde628c997b83cb64e1df9a218164d1ec686
-  data.tar.gz: ed456c724a0d80a36f7d78bd477a059d89142f68f85293ff9225eb8ad4cc9a1fc3900781cf888c36742bb4406161542d9935fef9e6e3dd3919d4da51fe4f390c
+  metadata.gz: e47256ec844eace9aabb20a1364fc0d0ab724e81c335f7b0bbb826871a328d8a0dca806d3e2ec891717339acc2286b2f71c2f424ccfed60c906772ded95f10ef
+  data.tar.gz: 0c584c14ec81977b7a26d66117a42180c73450da3a53ec9fa7dc5fe6ddd11e941833de45024032b3a8c7d31ddab6f7261911eaff7e2d83328031d7b8f4ddf9b2

data/README.md

@@ -14,7 +14,7 @@ class ProductAvailabilityWatcher < Wal::RecordWatcher
     recalculate_inventory_price(event.primary_key, event.new["price"])
   end
 
-  on_destroy Product do |event|
+  on_delete Product do |event|
     clear_product_inventory(event.primary_key)
   end
 

data/lib/wal/record_watcher.rb

@@ -27,7 +27,7 @@ module Wal
   #     end
   #   end
   #
-  #   on_destroy OrderItem do |event|
+  #   on_delete OrderItem do |event|
   #     recalculate_inventory_availability(event.attribute(:item_id))
   #   end
   #
@@ -60,7 +60,7 @@ module Wal
       @@change_callbacks[table].push(only: [:create, :update], changed: changed&.map(&:to_s), block: block)
     end
 
-    def self.on_destroy(table, &block)
+    def self.on_delete(table, &block)
       table = table.is_a?(String) ? table : table.table_name
       @@delete_callbacks[table].push(block: block)
     end
@@ -102,7 +102,7 @@ module Wal
       (@@change_callbacks.keys | @@delete_callbacks.keys).include? table
     end
 
-    # `RecordWatcher` supports two processing strategies:
+    # `RecordWatcher` supports three processing strategies:
     #
     # `:memory`: Stores and aggregates records from a single transaction in memory. This has better performance but uses
     #  more memory, as at least one event for each record must be stored in memory until the end of a transaction
@@ -110,6 +110,10 @@ module Wal
     # `:temporary_table`: Offloads the record aggregation to a temporary table on the database. This is useful when you
     # are processing very large transactions that can't fit in memory. The tradeoff is obviously a worse performance.
     #
+    # `:none`: Doesn't aggregate anything at all, so multiple updates on the same record on the same transaction would
+    # be notified. Also, if the same record is deleted on the same transaction it was created, this would end up
+    # triggering both `on_insert` and `on_delete` callbacks. This strategy should usually be avoided.
+    #
     # These strategies can be defined per transaction, and by default it will uses the memory one, and only fallback
     # to the temporary table if the transaction size is roughly 2 gigabytes or more.
     def aggregation_strategy(begin_transaction_event)
@@ -127,6 +131,8 @@ module Wal
           MemoryRecordWatcher.new(self)
         when :temporary_table
           TemporaryTableRecordWatcher.new(self)
+        when :none
+          NoAggregationWatcher.new(self)
         else
           raise "Invalid aggregation strategy: #{strategy}"
         end
@@ -134,6 +140,21 @@ module Wal
       @current_record_watcher.on_event(event)
     end
 
+    class NoAggregationWatcher
+      include Wal::Watcher
+
+      def initialize(watcher)
+        @watcher = watcher
+      end
+
+      def on_event(event)
+        case event
+        when InsertEvent, UpdateEvent, DeleteEvent
+          @watcher.on_record_changed(event)
+        end
+      end
+    end
+
     class MemoryRecordWatcher
       include Wal::Watcher
       include Wal::Watcher::SeparatedEvents

data/lib/wal/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wal
-  VERSION = "0.0.14"
+  VERSION = "0.0.15"
 end

data/rbi/wal.rbi

@@ -7,7 +7,7 @@ module Wal
       UpdateEvent,
       DeleteEvent,
     ) }
-  VERSION = "0.0.14"
+  VERSION = "0.0.15"
 
   class BeginTransactionEvent < T::Struct
     prop :transaction_id, Integer, immutable: true
@@ -128,7 +128,7 @@ module Wal
     def self.on_save(table, changed: nil, &block); end
 
     sig { params(table: T.any(String, T.class_of(::ActiveRecord::Base)), block: T.proc.bind(T.attached_class).params(event: Wal::DeleteEvent).void).void }
-    def self.on_destroy(table, &block); end
+    def self.on_delete(table, &block); end
 
     sig { params(event: RecordEvent).void }
     def on_record_changed(event); end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: wal
 version: !ruby/object:Gem::Version
-  version: 0.0.14
+  version: 0.0.15
 platform: ruby
 authors:
 - Rodrigo Navarro
 bindir: exe
 cert_chain: []
-date: 2025-09-14 00:00:00.000000000 Z
+date: 2025-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg