tina4ruby 3.13.162 → 3.13.163

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15151f90c7170c25e2174fdf43bbf5c847c65478b082dd5bdbda8049a5b57b97
-  data.tar.gz: a040ce2ecad0cfe976a1eb579c001e07c4f9f27244f8c1e35591ba1b536ea8cc
+  metadata.gz: 34f4ce86795d403ce1236cfcdd459faa59f11fd43f7cf9d3a9a3dc9d13ec5209
+  data.tar.gz: 1a613e2d130a451750e228b99daf2e33bba88b5378bdd5ccb83cd99f1fbc05c7
 SHA512:
-  metadata.gz: e1a7d0ff48f5310c2ee54a8d33c78bdfdcbdb1480a7633136cbde22cdea58c2e8b4f27845d1a21a14c79e4f4789c8b9fc009ec0bd61026a639ee0842598279c4
-  data.tar.gz: 1bead80a66a17fe802aac1efdd010695e884966c0b6848bfe18d6892899bd6f48e0854303afb67f303532649302201eb85ffcee7308b2cef304e2cd03f9ae2e4
+  metadata.gz: 60c7c05fee96e02aa8320b77e2ab0b6a1ed9458cc5456bcfb18284dc8ff4f1e5a1f0ee03e1056c0004590ef19e2f17c56c6466fd53665b0accb0fae356c39cda
+  data.tar.gz: 0232f479a2f5bcd8fa9e3cf0940ffcf717d2940919656762151b3abf6e6f88e4f2527715a483f5bfbb515d7772f97457ccb7b7c316125a845e2eb6ddbf958e42

data/CHANGELOG.md

@@ -6,6 +6,12 @@ number means the same thing everywhere.
 **The authoritative release notes for every shipped version live in the documentation:**
 https://tina4.com/ruby/36-releases
 
+## 3.13.163 - 2026-11-13
+
+### Fixed
+
+- A Kafka tombstone (a null-value record, such as a Debezium delete marker) no longer stops a consumer short. 3.13.162 stopped the crash but answered a tombstone with `nil`, so a single-pass drain (`consume(poll_interval: 0)`) read it as an empty queue: the records behind it were never reached, and a fresh process stopped at the same offset on every run. The poll loop now skips tombstones and keeps polling, still bounded by `dequeue`'s deadline (1 s steady state, the assign timeout on first subscribe). Nothing is committed on the tombstone path: acknowledging the next record commits past the skipped tombstones, so a restart gets past them. Acknowledge, retry and dead-letter are unchanged. Verified against a live broker producing real tombstones (#169, parity with tina4-python#309, tina4-php#357, tina4-nodejs#194).
+
 ## 3.13.162 - 2026-11-10
 
 ### Fixed

data/lib/tina4/queue_backends/kafka_backend.rb

@@ -150,15 +150,7 @@ module Tina4
         # TINA4_KAFKA_ASSIGN_TIMEOUT, default 15s); steady state stays one ~1s poll.
         deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) +
                    (first ? (ENV["TINA4_KAFKA_ASSIGN_TIMEOUT"] || "15").to_f : 1.0)
-        msg = nil
-        loop do
-          candidate = @consumer.poll(500)
-          if candidate
-            msg = candidate
-            break
-          end
-          break if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
-        end
+        msg = poll_past_tombstones(deadline)
         return nil unless msg
 
         job = job_from_message(topic, msg)
@@ -170,6 +162,22 @@ module Tina4
         nil
       end
 
+      # Poll until a record with a value arrives or the deadline passes.
+      #
+      # A tombstone carries no job: skip it and poll on. Returning nil at the
+      # first one read as an empty queue, so a single-pass drain
+      # (consume(poll_interval: 0)) stopped at the tombstone. The deadline holds
+      # while skipping too: a steady stream of tombstones must not hold dequeue
+      # past it. Nothing is committed here: acknowledging the next record commits
+      # past the skipped tombstones, as before.
+      def poll_past_tombstones(deadline)
+        loop do
+          candidate = @consumer.poll(500)
+          return candidate if candidate && !candidate.payload.nil?
+          return nil if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
+        end
+      end
+
       # Build a Job from a polled record, or nil for a record that carries no job.
       #
       # A null-value record is a tombstone / delete marker: Debezium emits these on

data/lib/tina4/version.rb

@@ -7,5 +7,5 @@
 
 
 module Tina4
-  VERSION = "3.13.162"
+  VERSION = "3.13.163"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.13.162
+  version: 3.13.163
 platform: ruby
 authors:
 - Tina4 Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-11-12 00:00:00.000000000 Z
+date: 2026-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sqlite3