pgoutput-client 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 697aed85b1c507b7c0e6707bdff020075f31c35c1be6f74a3dff9a060987d69e
-  data.tar.gz: ae49847c1b076c79754149cf3b7db0f32ee14f487a1c1ab03531b4a37fc42ab8
+  metadata.gz: a375cce8bbb2d330974bfd22bdc0a7542c1c1ed5fe73f448e41bba717532aac2
+  data.tar.gz: 3c20c8e182548d5556d4a8a503a92d2d8c89d5c926a59eaaf537812d4bb5cdca
 SHA512:
-  metadata.gz: 326686eeecf787c33b5ed9daa8d0491fa441a17ac9936666b7e130fba67a1fdaa6b136a86ed903398fd6d2c48e4037199763e03d8390bd5671184e28311eb5f6
-  data.tar.gz: 68290690628bef4393ef04867fdfd63337159e85505943062960173a9e5c0eaffb2b00b18eec03372f8d4cba4f02cb2601166eb2d25d98fd0cf6e0ebac387ff9
+  metadata.gz: 78fc7ede75ae5fcd4b27adddef61d1f6b59ba8a26943bb44bf93d0dc5f2d97a477f36d12ec935fdf083792cbc8d37418e0b2a9f84fb7d14d15aa7e5847f8d2fd
+  data.tar.gz: 58ea9e8475789846b3caad462fcfef693df07ad8ef9cf724e877f38ba2ca53a73b3e1476971a7b5b1c9ad47bb0b8c20fae2e31f47674a377bf03c7d09cb1533c

data/CHANGELOG.md

@@ -2,6 +2,71 @@
 
 ## Unreleased
 
+## 0.2.3 - 2026-06-17
+
+### Fixed
+
+* Fixed automatic replication slot creation when `auto_create_slot` is enabled.
+* Fixed startup failure when the configured replication slot already exists.
+* Improved logical replication restart behavior for persistent replication slots.
+* Improved lifecycle management of existing replication slots across process and container restarts.
+
+### Changed
+
+* `auto_create_slot` now follows **ensure slot exists** semantics.
+* Existing replication slots are treated as valid and reusable when automatic slot creation is enabled.
+* Slot creation remains automatic for missing slots and idempotent for existing slots.
+
+### Internal
+
+* Hardened replication slot lifecycle handling.
+* Expanded coverage around automatic slot creation scenarios.
+* Updated signatures and tests for slot creation behavior.
+
+
+## 0.2.2 - 2026-06-17
+
+### Added
+
+* Added periodic standby status feedback while replication streams are idle.
+* Added E2E coverage for PostgreSQL restart and replication recovery.
+* Added E2E validation of replication slot resume behavior after reconnect.
+* Added test coverage for idle replication streams.
+
+### Changed
+
+* Increased reconnect retry budget to better tolerate PostgreSQL restart windows.
+* Improved replication stream resilience during transient PostgreSQL outages.
+* Improved reconnect behavior when PostgreSQL is starting up and temporarily rejecting connections.
+
+### Fixed
+
+* Fixed replication timeout during idle logical replication streams.
+
+* Fixed walsender termination caused by missing standby feedback during periods without WAL activity.
+
+* Fixed reconnect handling after PostgreSQL restart.
+
+* Fixed connection recovery when PostgreSQL reports:
+
+  ```
+  FATAL: the database system is starting up
+  ```
+
+* Fixed E2E PostgreSQL test infrastructure and restart recovery validation.
+
+* Fixed test isolation between unit and E2E PostgreSQL connection paths.
+
+### Internal
+
+* Expanded transport lifecycle validation.
+* Improved operational reliability of long-running replication sessions.
+
+
+## [0.2.1] - 2026-06-16
+
+- Gemspec summary and description improvement release only
+
 ## [0.2.0] - 2026-06-16
 
 ### Fixed

data/lib/pgoutput/client/runner.rb

@@ -37,7 +37,7 @@ module Pgoutput
     # @see Stream
     # @api public
     class Runner
-      DEFAULT_RECONNECT_ATTEMPTS = 3
+      DEFAULT_RECONNECT_ATTEMPTS = 30
       DEFAULT_RECONNECT_BACKOFF = 0.5
 
       # Configuration used by this runner.
@@ -70,6 +70,7 @@ module Pgoutput
         @resume_lsn = configuration.start_lsn
         @acked_lsn = configuration.start_lsn
         @slot_created = false
+        @connected_once = false
         @last_error = nil
         @reconnect_attempts = 0
       end
@@ -193,26 +194,38 @@ module Pgoutput
       private
 
       def setup_connection(connection)
-        if configuration.auto_create_slot && !@slot_created
-          connection.create_replication_slot
-          @slot_created = true
-        end
+        ensure_replication_slot(connection) if configuration.auto_create_slot && !@slot_created
 
         connection.start_replication
       end
 
+      def ensure_replication_slot(connection)
+        connection.create_replication_slot
+        @slot_created = true
+      rescue ConnectionError => e
+        raise unless replication_slot_already_exists?(e)
+
+        @slot_created = true
+      end
+
+      def replication_slot_already_exists?(error)
+        error.message.match?(/replication slot .* already exists/i)
+      end
+
       def run_stream_cycle(configuration, &block)
         connection = Connection.open(configuration)
         setup_connection(connection)
+        @connected_once = true
         @stream = Stream.new(connection:, configuration:, acked_lsn: @acked_lsn)
         @stream.start(&block)
         :done
       rescue ConnectionError => e
         @last_error = e
-        raise if @stopped || @stream.nil?
+        raise if @stopped
+        raise if @stream.nil? && !@connected_once
 
-        @resume_lsn = @stream.latest_lsn || @resume_lsn
-        @acked_lsn = @stream.acked_lsn || @acked_lsn
+        @resume_lsn = @stream&.latest_lsn || @resume_lsn
+        @acked_lsn = @stream&.acked_lsn || @acked_lsn
         :retry
       ensure
         @stream = nil

data/lib/pgoutput/client/stream.rb

@@ -78,6 +78,7 @@ module Pgoutput
         while @running
           copy_data = @connection.get_copy_data
           if copy_data.nil?
+            send_periodic_feedback
             sleep 0.01
             next
           end

data/lib/pgoutput/client/version.rb

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

data/sig/pgoutput/client/runner.rbs

@@ -53,7 +53,7 @@ module Pgoutput
 
       @reconnect_attempts: untyped
 
-      DEFAULT_RECONNECT_ATTEMPTS: 3
+      DEFAULT_RECONNECT_ATTEMPTS: 30
 
       DEFAULT_RECONNECT_BACKOFF: ::Float
 
@@ -83,6 +83,10 @@ module Pgoutput
 
       def setup_connection: (untyped connection) -> untyped
 
+      def ensure_replication_slot: (untyped connection) -> untyped
+
+      def replication_slot_already_exists?: (untyped error) -> bool
+
       def run_stream_cycle: (untyped configuration) { (?) -> untyped } -> untyped
 
       def configuration_for_resume: () -> untyped

metadata

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