pgoutput-client 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1413514b4a4dbe4f3c0f4c59744931ed865ca6faea5662f33844c0786a46e287
-  data.tar.gz: ebb972e2f0dd5a40f46161d6cd5be70df2f42db42e05862edf16f11e0f9a15ef
+  metadata.gz: f4b5412d12b81f8e787d00975419c7478af45fb47d0fa0f616876a9141f47396
+  data.tar.gz: 9a77f1cbb0c438312fdefa4045f89f2359829751a96e6131f20ffc9ce4ccc6b2
 SHA512:
-  metadata.gz: 7cb26f20d9a5a86c231956cb801c98b269aeebcf969dc2408b8ded3dbcae9a1b7995f88179480cbdd59c6f99b9d5df9d7910db78f0d84175d74fcc7e1ac6a0f5
-  data.tar.gz: 93a66bfe718e050fc636c77e78dcc1dd8c8bce064d64794f982944e9dc7a83ed261e3831a88d91ce1a6acb4c2498a5506135d815a8f6d278f5ff1fda168dc868
+  metadata.gz: e067f71e70ade6f7cf25d543edbfac7f79058e6a8b79a35457a6320365e574d7c8c12ecbdecd74355eff1aa641eabde1c926e74dc52513e7a1ad101461a7375d
+  data.tar.gz: e66ed2183b869dc7074595fc2509763d5da468ddd7f21a5ed10617990405da21b720df5131de01771beaed5532970073eed56bbbd1517a40bb271019b34f8af9

data/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 ## Unreleased
 
+## 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/README.md

@@ -367,4 +367,4 @@ bundle exec rake e2e:run
 
 ## License
 
-MIT.
+[MIT](LICENSE.txt).

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
@@ -204,15 +205,17 @@ module Pgoutput
       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.0"
+    VERSION = "0.2.2"
   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
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgoutput-client
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Ken C. Demanawa
@@ -23,8 +23,18 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.6'
-description: Transport-only PostgreSQL logical replication client for receiving pgoutput
-  CopyData payloads.
+description: |
+  pgoutput-client provides a PostgreSQL logical replication transport for Ruby.
+
+  It manages replication connections, lifecycle, monitoring,
+  keepalive handling, graceful shutdown, and transport-level
+  acknowledgment boundaries while streaming pgoutput messages
+  to downstream consumers.
+
+  pgoutput-client owns transport.
+
+  Parsers, decoders, source adapters, runtimes, and sinks remain
+  separate concerns within the CDC ecosystem.
 email:
 - kenneth.c.demanawa@gmail.com
 executables: []
@@ -86,5 +96,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: PostgreSQL pgoutput logical replication transport client.
+summary: PostgreSQL pgoutput logical replication transport and lifecycle management
+  for Ruby.
 test_files: []