datagrout-conduit 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c26778c726d9e0e83c8573f84f3972778b6b95cbc837ead0b2c889344955aa4c
-  data.tar.gz: 87ad9ad6ead32c2a538205bfd2f99176b1a0aeb1163ef2e2609ca41cbb8bcf53
+  metadata.gz: 177af76b0cdd7d7e82fd1384db89da6a5dd4b3152ff5f07e255075dec041a91c
+  data.tar.gz: 34b1c4d17471013349db85beb09f167719e4fc0189204b117042c1394fc175f8
 SHA512:
-  metadata.gz: 327ddcec7d5910ea28d060e8e48cef5863aa8f6c4023108924e497a8f2d3ed818e29b87599d12f3be5203f5a20491a864b0e60d80f1c24b335cf868424338829
-  data.tar.gz: 1d976c43dc5346f5afa9fb01b84a6bb6e04cd275bca7563a75815bfd156f115bfdb5d8aada4b3b45201704d696ad17ea80a1f2f06debc8b61ff570b05d34fcab
+  metadata.gz: 6812db873347c88a86bfd0ecce380e6d264b4f66854d3eeb01e3ee4a28b89cf2b6e8f93423442ea9b0c14fcb40c68cd6bcc2d6210a5f343200115dd92343ff35
+  data.tar.gz: 23deaeee4cfe9be72cc546b919e5a87cb5ea5fa108831c346a4e02b0faa501578b582632f538a42dd0456095a9b8589511e349318c95f414b086bed7a0d90980

data/lib/datagrout_conduit/transport/ws.rb

@@ -32,6 +32,14 @@ module DatagroutConduit
     class Ws
       SUBPROTOCOL = "datagrout-jsonrpc.v1"
 
+      # Seconds between client-initiated WS ping frames.
+      #
+      # Many load balancers and reverse proxies (nginx, AWS ALB) close idle
+      # WS connections after 60-120 seconds; pinging every 25 seconds keeps
+      # the connection alive well within the tightest common timeout window.
+      # Mirrors PING_INTERVAL in the Rust reference implementation.
+      PING_INTERVAL_SECONDS = 25
+
       # ── Subscription ─────────────────────────────────────────────────────────
 
       # Per-subscription event stream delivered via a thread-safe Queue.
@@ -98,7 +106,7 @@ module DatagroutConduit
 
       # ── Construction ─────────────────────────────────────────────────────────
 
-      def initialize(url:, auth: {}, identity: nil)
+      def initialize(url:, auth: {}, identity: nil, ping_interval: PING_INTERVAL_SECONDS)
         @url      = url
         @auth     = normalize_auth(auth)
         @identity = identity
@@ -113,9 +121,16 @@ module DatagroutConduit
         @io          = nil
         @driver      = nil
         @read_thread = nil
+        @ping_thread = nil
+        @ping_interval = ping_interval.to_f
+        @pings_sent   = 0
         @connected   = false
       end
 
+      # Number of ping frames this transport has sent over its lifetime.
+      # Exposed for tests; production code can ignore it.
+      attr_reader :pings_sent, :ping_interval
+
       # ── Public API ────────────────────────────────────────────────────────────
 
       # Establish the WebSocket connection.
@@ -145,6 +160,7 @@ module DatagroutConduit
         raise ConnectionError, "WebSocket handshake failed: #{err}" if err
 
         @connected = true
+        start_ping_thread
         self
       rescue Timeout::Error
         cleanup_socket
@@ -423,6 +439,7 @@ module DatagroutConduit
       end
 
       def cleanup_socket
+        stop_ping_thread
         @write_mutex.synchronize do
           @driver = nil
         end
@@ -432,6 +449,44 @@ module DatagroutConduit
         @io = nil
       end
 
+      # ── Ping keepalive ───────────────────────────────────────────────────────
+
+      # Start the background ping thread. Sends one WS ping frame every
+      # @ping_interval seconds until the connection is torn down. No-op when
+      # @ping_interval is non-positive (used by tests to disable pinging).
+      def start_ping_thread
+        return if @ping_thread
+        return if @ping_interval <= 0
+
+        interval = @ping_interval
+        @ping_thread = Thread.new do
+          loop do
+            sleep interval
+            break unless @connected
+
+            driver = @driver
+            break unless driver
+
+            begin
+              # WebSocket::Driver#ping returns false if the connection is
+              # already closing; treat that as "stop the loop" too.
+              @write_mutex.synchronize { driver.ping } || break
+              @pings_sent += 1
+            rescue StandardError
+              break
+            end
+          end
+        end
+        @ping_thread.abort_on_exception = false
+        @ping_thread.name = "conduit-ws-ping"
+      end
+
+      def stop_ping_thread
+        thread = @ping_thread
+        @ping_thread = nil
+        thread&.kill
+      end
+
       # ── Helpers ───────────────────────────────────────────────────────────────
 
       def ensure_connected!

data/lib/datagrout_conduit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DatagroutConduit
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: datagrout-conduit
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - DataGrout
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-19 00:00:00.000000000 Z
+date: 2026-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday