wal 0.0.13 → 0.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edfabb02eb019e1831b90121434be496668526305dc7cf7fb37a6d870adfcebf
-  data.tar.gz: b57e3cdafe8271d100fa2d8b4b3043023dfc28d11217c15094887a8bb148b09f
+  metadata.gz: 14c30e66cc9c1425cb894a9cfb558941017659cf4f0ad5a2183782c25df4a5b4
+  data.tar.gz: 7704871035cecbb90ee47cbefff50ad2fe58b4515f7d2c0d439e40adf31bf3f4
 SHA512:
-  metadata.gz: 723a809da119ab2d144fcf04862b790b33a14c45a961027613eaeaa7db245a4465d9a177ac130537ab24de7be2acc8449f120307efa8421b550142b2c3c47924
-  data.tar.gz: 152d8bf513c3a0913dcb054446dcf8cfe7cde4e0bd8603240f52df3966dd7ef9907e60c01e483a26d6543e6ece795dde7ab8200f6c9c675354a60407c849f07c
+  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/exe/wal

@@ -45,11 +45,6 @@ if cli["watch"]
 elsif cli["start"]
   slots = YAML.load_file(cli["<config-file>"])["slots"]
 
-  if slots.size > 1 && slots.values.any? { |slot| slot["replicator"] == "Wal::Pro::Replicator" }
-    $stderr.puts "Error: wal-pro doesn't support multiple replication slots"
-    exit 1
-  end
-
   workers = slots.map do |slot, config|
     watcher = config["watcher"].constantize.new
     temporary = config["temporary"] || false

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.13"
+  VERSION = "0.0.15"
 end

data/rbi/wal.rbi

@@ -7,7 +7,7 @@ module Wal
       UpdateEvent,
       DeleteEvent,
     ) }
-  VERSION = "0.0.13"
+  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.13
+  version: 0.0.15
 platform: ruby
 authors:
 - Rodrigo Navarro
 bindir: exe
 cert_chain: []
-date: 2025-09-10 00:00:00.000000000 Z
+date: 2025-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg