tricoredb 0.1.0 → 0.3.0

data/lib/tricoredb/errors.rb

@@ -4,6 +4,11 @@ module TriCoreDB
   # The code a not-leader refusal carries in `diagnostics.error_code`.
   NOT_LEADER = "not_leader"
 
+  # The code of a request a follower handed to the leader and lost the answer
+  # to, or one the leader could not confirm. It may or may not have been
+  # applied, so the client never sends it again.
+  OUTCOME_UNKNOWN = "outcome_unknown"
+
   # Base class for every failure raised by this gem.
   #
   # Branch on {#code}, never on the message: the message is prose the server is
@@ -25,9 +30,8 @@ module TriCoreDB
 
     # Whether the request was right but reached a node that is not the leader.
     #
-    # The driver never follows {#leader_hint} on its own: the address may not be
-    # reachable from this client, a new connection must authenticate again, and
-    # an open session transaction cannot move to another node at all.
+    # Unless `follow_leader: false` was passed to {Client.connect}, the client
+    # has already sent the request again before raising this.
     #
     # @return [Boolean]
     def redirect?

data/lib/tricoredb/response.rb

@@ -111,18 +111,23 @@ module TriCoreDB
     #
     # @param txn_open [Boolean] whether a session transaction was open on the connection
     # @return [ServerError]
-    def to_error(txn_open = false)
+    def to_error(txn_open = false, retried: 0)
       text = arm("Message") || (arm?("Json") ? JSON.generate(arm("Json")) : nil) || "request failed"
       message = "#{text} (server status: #{@status})"
       if redirect?
         message += if leader_hint
-                     " [not_leader: the leader serves clients at `#{leader_hint}`. This driver does not follow " \
-                     "the hint on its own; send the request there."
+                     " [not_leader: the leader serves clients at `#{leader_hint}`."
                    else
                      " [not_leader: there is no leader address to name (an election is in progress, or the " \
-                     "leader has no address configured). Wait and try again."
+                     "leader has no address configured)."
                    end
-        message += " The open session transaction is over: it cannot continue on another node." if txn_open
+        if txn_open
+          message += " The open session transaction is over: it cannot continue on another node."
+        elsif retried.nil?
+          message += " Following the leader is off (follow_leader: false): send the request there yourself."
+        elsif retried.positive?
+          message += " The client sent it again #{retried} time(s) and was refused each time."
+        end
         message += "]"
       end
       ServerError.new(message, code: error_code, leader_hint: leader_hint, status: @status, response: self)

data/lib/tricoredb/version.rb

@@ -2,5 +2,5 @@
 
 module TriCoreDB
   # The version of this gem. Distinct from {Frame::VERSION}, the wire format.
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tricoredb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Trinesh Kumar
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest