pgoutput-client 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a0c63a95d0df00f5a4b8b5a0e85b01bbec1ed71688a41f853c065e2f2b01a03
-  data.tar.gz: 3e86b0d6e62c54c03edd73a86be9dce33997a60f2d5bd097459b3a2a0d75795a
+  metadata.gz: a79d1b00595418c8536658073164d8c4d29ad90fe79f5ba58b04e4ee80dd90a1
+  data.tar.gz: 436b7bd8d0aedae584d4b5f702635cca25f96d78857fd736c3fde5d41d1be52d
 SHA512:
-  metadata.gz: 0577c07284f05bb0daa59ae055a39cdd456e2104f936c33b8a921473fb5554cf65dfae2f9d9d69ce82900e27dfb1a0f632c960654bae7526b73b62ab664f6007
-  data.tar.gz: e2ea5d853aee2079d280139f58f287063fc411e8ef846782c14b8f41c286bd1975027022ecfa395619f5494ce5622d640fc0a9b6bd1a0ca9a192ebbab5701d20
+  metadata.gz: ea61369e9d3ce153ce50b1f24e7335914feb898ca3e52cea20cdb0aa9875ad88a20342b2badc35c81a6fb95a941e8f36ebfdb3e3762c4f3ff421cd9cc4bfed3a
+  data.tar.gz: fb24fa3565d7d626282c5d8bdd3b5502b9cd22d168359522b741990a0d1dd10e616e921a65c3dc92beefcbcae5470484872a21a6caba6420b47d3079af62e930

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.4.0 - 2026-07-17
+
+### Added
+
+- Added `SlotStatus#retained_wal_bytes`, computed by PostgreSQL from the current
+  WAL position and the slot's `restart_lsn`.
+
 ## 0.3.0 - 2026-07-17
 
 ### Added

data/README.md

@@ -254,6 +254,7 @@ if status.nil?
 else
   puts status.restart_lsn
   puts status.confirmed_flush_lsn
+  puts status.retained_wal_bytes
   puts status.wal_status
   puts status.invalidation_reason
 end
@@ -278,7 +279,7 @@ WAL position, retention, and invalidation fields including:
 
 - `slot_name`, `plugin`, `slot_type`, and `database`
 - `active`, `active_pid`, and `inactive_since`
-- `restart_lsn` and `confirmed_flush_lsn`
+- `restart_lsn`, `confirmed_flush_lsn`, and `retained_wal_bytes`
 - `wal_status`, `safe_wal_size`, and `catalog_xmin`
 - `conflicting` and `invalidation_reason`
 

data/lib/pgoutput/client/runner.rb

@@ -111,15 +111,13 @@ module Pgoutput
 
         loop do
           current_configuration = configuration_for_resume
-          case run_stream_cycle(current_configuration, &block)
-          when :done
-            break
-          when :retry
-            @reconnect_attempts += 1
-            raise @last_error if @reconnect_attempts > DEFAULT_RECONNECT_ATTEMPTS
-
-            sleep(reconnect_backoff_for(@reconnect_attempts))
-          end
+          result = run_stream_cycle(current_configuration, &block)
+          break if result == :done
+
+          @reconnect_attempts += 1
+          raise @last_error if @reconnect_attempts > DEFAULT_RECONNECT_ATTEMPTS
+
+          sleep(reconnect_backoff_for(@reconnect_attempts))
         end
       ensure
         @running = false

data/lib/pgoutput/client/slot_inspector.rb

@@ -18,7 +18,14 @@ module Pgoutput
       #
       # @return [String]
       QUERY = <<~SQL
-        SELECT to_jsonb(slot) AS slot
+        SELECT
+          to_jsonb(slot) || jsonb_build_object(
+            'retained_wal_bytes',
+            CASE
+              WHEN slot.restart_lsn IS NULL THEN NULL
+              ELSE pg_wal_lsn_diff(pg_current_wal_lsn(), slot.restart_lsn)::bigint
+            END
+          ) AS slot
         FROM pg_catalog.pg_replication_slots AS slot
         WHERE slot.slot_name = $1
       SQL

data/lib/pgoutput/client/slot_status.rb

@@ -20,6 +20,7 @@ module Pgoutput
       :catalog_xmin,
       :restart_lsn,
       :confirmed_flush_lsn,
+      :retained_wal_bytes,
       :wal_status,
       :safe_wal_size,
       :inactive_since,
@@ -36,27 +37,18 @@ module Pgoutput
       # @param attributes [Hash{String, Symbol=>Object}] catalog attributes
       # @return [SlotStatus]
       def self.from_catalog(attributes)
-        fetch = lambda do |key|
-          next attributes[key] if attributes.key?(key)
-
-          attributes[key.to_sym]
-        end
+        value = ->(key) { attributes.fetch(key) { attributes[key.to_sym] } }
 
         new(
-          slot_name: fetch.call("slot_name"),
-          plugin: fetch.call("plugin"),
-          slot_type: fetch.call("slot_type"),
-          database: fetch.call("database"),
-          active: fetch.call("active") == true,
-          active_pid: fetch.call("active_pid"),
-          catalog_xmin: fetch.call("catalog_xmin"),
-          restart_lsn: fetch.call("restart_lsn"),
-          confirmed_flush_lsn: fetch.call("confirmed_flush_lsn"),
-          wal_status: fetch.call("wal_status"),
-          safe_wal_size: fetch.call("safe_wal_size"),
-          inactive_since: fetch.call("inactive_since"),
-          conflicting: fetch.call("conflicting"),
-          invalidation_reason: fetch.call("invalidation_reason")
+          slot_name: value.call("slot_name"), plugin: value.call("plugin"),
+          slot_type: value.call("slot_type"), database: value.call("database"),
+          active: value.call("active") == true, active_pid: value.call("active_pid"),
+          catalog_xmin: value.call("catalog_xmin"), restart_lsn: value.call("restart_lsn"),
+          confirmed_flush_lsn: value.call("confirmed_flush_lsn"),
+          retained_wal_bytes: value.call("retained_wal_bytes"),
+          wal_status: value.call("wal_status"), safe_wal_size: value.call("safe_wal_size"),
+          inactive_since: value.call("inactive_since"), conflicting: value.call("conflicting"),
+          invalidation_reason: value.call("invalidation_reason")
         )
       end
     end

data/lib/pgoutput/client/version.rb

@@ -5,6 +5,6 @@ module Pgoutput
     # Current pgoutput-client gem version.
     #
     # @return [String]
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

data/lib/pgoutput/client/xlog_data.rb

@@ -44,7 +44,7 @@ module Pgoutput
         wal_start = unpack_u64(binary, 1)
         wal_end = unpack_u64(binary, 9)
         server_clock = unpack_u64(binary, 17)
-        payload = binary.byteslice(25..)&.freeze || "".b.freeze
+        payload = binary.unpack1("@25a*").freeze
 
         Ractor.make_shareable(new(wal_start, wal_end, server_clock, payload))
       end

data/sig/pgoutput/client/slot_status.rbs

@@ -10,6 +10,7 @@ module Pgoutput
       attr_reader catalog_xmin: String?
       attr_reader restart_lsn: String?
       attr_reader confirmed_flush_lsn: String?
+      attr_reader retained_wal_bytes: Integer?
       attr_reader wal_status: String?
       attr_reader safe_wal_size: Integer?
       attr_reader inactive_since: String?
@@ -26,6 +27,7 @@ module Pgoutput
         catalog_xmin: String?,
         restart_lsn: String?,
         confirmed_flush_lsn: String?,
+        retained_wal_bytes: Integer?,
         wal_status: String?,
         safe_wal_size: Integer?,
         inactive_since: String?,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgoutput-client
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ken C. Demanawa