skaidb 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a452610f682221a59cfbbc48e42c9a37f1c0e880d2191037f1c9c7151a3034fa
-  data.tar.gz: 1a73f7f552091bfaed9b4072dfd684b57daac637ff12d163a34bf1c278bef784
+  metadata.gz: f947092b55d66cc8d7c55153cbea09ebcdd0298f48fcb6c97ea0f3a5edd5ac01
+  data.tar.gz: 9b472d16803f161f2aa6d4554c19aede65f9a227b79d29c7f015204c04a7bcc7
 SHA512:
-  metadata.gz: ce44a1e28e0add382aa9fde578eb09350e1b5306d22c3cf5d272faa5d606c8ec05be08b77967d014a33ceddba5fefd0ed449503c24d4997680c37af156ad2e5f
-  data.tar.gz: 3d34175d862982988e593fb42c631bdbb9cd6f23682908ec40fc53a7d25fe3868105201dd50988108508783bfb8bf076065737864d71c6cc5337c8b6c371e6c3
+  metadata.gz: 68d82f58f409113c18f1536023042343ffbfa86c8ec6029a0f799cd8f88fd038f418ced9c1be77beca7826c7d5756e523de221c6bf798e7069db1e14be7aaf12
+  data.tar.gz: f95915e0918b17e31d2b9e63cfbcbe92ee717f07b49075bbd1da055cb49f60f592c346eb579b6c65a8dc855ddf669c41d467086dec90ccb59abc0861c784dacc

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to the skaidb Ruby driver. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
 [Semantic Versioning](https://semver.org/).
 
+## [1.4.0] - 2026-10-29
+
+### Fixed
+- A streamed `CALL` whose procedure body `EMIT`s result sets returns them.
+  The server answers such a call with every set in one `ResultSets` frame
+  (tag 8) even to a stream request, and `conn.stream`, with or without
+  parameters, raised `QueryError` (`unexpected response tag 8 to stream
+  request`) and lost the sets. The frame is now decoded by the code `exec`
+  uses: the block receives the rows `exec`'s `Result` would yield (the
+  call's final result, the LAST set) and `stream` returns that same `:rows`
+  `Result`, every set in order under `result_sets`. Nothing is left in
+  flight, so the connection stays usable — the block may even run
+  statements on it.
+
 ## [1.3.0] - 2026-10-29
 
 ### Added

data/README.md

@@ -55,13 +55,13 @@ Xcode command-line tools on macOS). `gem install skaidb` and vendoring reuse
 the `bigdecimal` already installed.
 
 Or vendor the single file: copy
-[`lib/skaidb.rb`](https://github.com/porcupin26/skaidb-ruby/blob/v1.3.0/lib/skaidb.rb)
+[`lib/skaidb.rb`](https://github.com/porcupin26/skaidb-ruby/blob/v1.4.0/lib/skaidb.rb)
 into your project and `require_relative` it. It has no dependencies beyond
 Ruby's standard library.
 
 Every release is also attached as a `.gem` to its
 [GitHub release](https://github.com/porcupin26/skaidb-ruby/releases) for
-installs without registry access: `gem install ./skaidb-1.3.0.gem`.
+installs without registry access: `gem install ./skaidb-1.4.0.gem`.
 
 ## Quick start
 
@@ -306,7 +306,10 @@ unordered or in storage-key order), and no scan budget applies to a streamed
 page (server ≥ 0.330). With a block `stream` returns a `Result` whose `kind`
 is `:stream` and whose `fields` are the column names (the rows went to the
 block); a non-row statement returns its `:mutation` / `:ddl` Result without
-yielding.
+yielding. A `CALL` whose body `EMIT`s result sets is answered with all of
+them in one frame even when streamed: the block receives the rows `exec`
+would return (the last set), and `stream` returns that same `Result`, every
+set under `result_sets`.
 
 **The abandon/drain rule.** The connection is busy for the whole stream:
 a statement from another thread waits for it. Leaving the block early —
@@ -458,7 +461,7 @@ frame after every handshake. It shows up as `client_name = 'ruby'` /
 
 ```sql
 SELECT client_name, client_version FROM drivers;
--- ruby | 1.3.0
+-- ruby | 1.4.0
 ```
 
 The server records the row asynchronously, so a `SELECT` immediately after

data/docs/api.md

@@ -67,7 +67,10 @@ Raises `Skaidb::Error` before dialing for an unknown `auth_mechanism`, a
   `ArgumentError`. For a row stream the returned Result has
   `kind == :stream`, the column names in `fields` and no `rows` (they went to
   the block); a statement without rows returns its `:mutation` / `:ddl`
-  Result without yielding. Without a block returns an Enumerator.
+  Result without yielding; a `CALL` whose body `EMIT`s result sets (answered
+  in one frame even when streamed) yields the rows `exec` would return (the
+  last set) and returns that same `:rows` Result, every set under
+  `result_sets`. Without a block returns an Enumerator.
 - `subscribe(stream_name, after: nil, poll: 0.5) { |event| … }` — yields a
   `CREATE STREAM` log's events forever, each a Hash with `"id"`, `"op"`,
   `"k"`, `"ts"`, `"doc"`. Polls `_stream_<name>` 500 rows at a time with a

data/docs/streaming.md

@@ -28,6 +28,12 @@ end
 - A non-row statement (an `INSERT`, DDL, `USE`) answers with its ordinary
   result over the same opcode; `stream` returns that Result (`kind`
   `:mutation` with `cmd_tuples`, or `:ddl`) without yielding.
+- A `CALL` whose procedure body `EMIT`s result sets answers with all of them
+  in one frame, as it does to `exec`: the block receives the rows `exec`
+  would return (the call's final result, the last set) and `stream` returns
+  that same `:rows` Result, every set in order under `result_sets`. Nothing
+  is left in flight, so the connection is free again before the first row
+  reaches the block.
 - A server without the streaming opcode raises `Skaidb::QueryError`
   (`server does not support streaming: …`).
 

data/lib/skaidb.rb

@@ -35,7 +35,7 @@ require "bigdecimal"
 module Skaidb
   # The package version — the single source of truth. The gemspec reads it,
   # and it is what the driver reports to the server in the Hello frame.
-  VERSION = "1.3.0"
+  VERSION = "1.4.0"
 
   # Base class for every error raised by this driver.
   class Error < StandardError; end
@@ -973,7 +973,12 @@ module Skaidb
     # +kind+ is +:stream+ and +fields+ holds the column names (known even when
     # no row arrived) while +rows+ stays empty — the rows went to the block;
     # a statement that produces no rows returns its ordinary +:mutation+ or
-    # +:ddl+ Result without yielding.
+    # +:ddl+ Result without yielding. A CALL whose body EMITs result sets is
+    # answered with all of them in one frame, streamed or not: the block
+    # receives the rows exec's Result would yield (the call's final result,
+    # the LAST set) and the return value is that same +:rows+ Result, every
+    # set under +result_sets+ — with nothing left in flight, so the block may
+    # use the connection.
     def stream(sql, params = [], consistency: nil)
       return enum_for(:stream, sql, params, consistency: consistency) unless block_given?
       raise ConnectionError, "connection is closed" if @closed
@@ -991,6 +996,7 @@ module Skaidb
 
       live = false
       summary = nil
+      sets = nil
       @mutex.synchronize do
         started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
         begin
@@ -1015,6 +1021,12 @@ module Skaidb
           return Result.new(fields: [], rows: [], cmd_tuples: r.u64, kind: :mutation) # not row-producing
         when 2
           return Result.new(fields: [], rows: [], cmd_tuples: 0, kind: :ddl)
+        when 8
+          # ResultSets: a CALL whose body EMITted is answered with every set
+          # in ONE frame, streamed or not — the frame exec receives, decoded
+          # by the same code. Nothing follows it, so the rows are yielded
+          # below, with the connection free.
+          sets = parse_result_sets(r)
         when 5
           # The server has already committed to a row stream, so from here
           # the socket carries frames this call owns — mark it BEFORE
@@ -1065,6 +1077,12 @@ module Skaidb
           raise QueryError, "unexpected response tag #{tag} to stream request"
         end
       end
+      if sets
+        # What exec's Result yields (the call's final result, the LAST set),
+        # and that same Result back, every set under +result_sets+.
+        sets.each { |row| yield row }
+        return sets
+      end
       summary
     end
 
@@ -1388,27 +1406,9 @@ module Skaidb
       tag = r.u8
       case tag
       when 0 # Rows
-        ncols = r.u32
-        columns = Array.new(ncols) { r.text }
-        nrows = r.u32
-        rows = Array.new(nrows) do
-          ncells = r.u32
-          Array.new(ncells) { Skaidb.decode_value(Reader.new(r.blob)) }
-        end
-        Result.new(fields: columns, rows: rows, cmd_tuples: 0)
+        parse_rows(r)
       when 8 # ResultSets: a CALL whose body EMITted
-        sets = Array.new(r.u32) do
-          ncols = r.u32
-          columns = Array.new(ncols) { r.text }
-          nrows = r.u32
-          rows = Array.new(nrows) do
-            ncells = r.u32
-            Array.new(ncells) { Skaidb.decode_value(Reader.new(r.blob)) }
-          end
-          Result.new(fields: columns, rows: rows, cmd_tuples: 0)
-        end
-        last = sets.last || Result.new(fields: [], rows: [], cmd_tuples: 0)
-        Result.new(fields: last.fields, rows: last.rows, cmd_tuples: 0, result_sets: sets)
+        parse_result_sets(r)
       when 1 # Mutation
         Result.new(fields: [], rows: [], cmd_tuples: r.u64, kind: :mutation)
       when 2 # Ddl
@@ -1419,6 +1419,29 @@ module Skaidb
         raise ConnectionError, "unknown response tag #{tag}"
       end
     end
+
+    # A Rows body (PROTOCOL.md §3.2), also one set of ResultSets; +r+ sits
+    # just past the tag.
+    def parse_rows(r)
+      ncols = r.u32
+      columns = Array.new(ncols) { r.text }
+      nrows = r.u32
+      rows = Array.new(nrows) do
+        ncells = r.u32
+        Array.new(ncells) { Skaidb.decode_value(Reader.new(r.blob)) }
+      end
+      Result.new(fields: columns, rows: rows, cmd_tuples: 0)
+    end
+
+    # A ResultSets body (a CALL whose body EMITted), +r+ just past the tag:
+    # the LAST set is the Result's own rows, every set is under
+    # +result_sets+. The buffered path and a stream request both receive
+    # this frame, and both decode it here.
+    def parse_result_sets(r)
+      sets = Array.new(r.u32) { parse_rows(r) }
+      last = sets.last || Result.new(fields: [], rows: [], cmd_tuples: 0)
+      Result.new(fields: last.fields, rows: last.rows, cmd_tuples: 0, result_sets: sets)
+    end
   end
 
   # ---- module entry point --------------------------------------------------

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: skaidb
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - skaidb contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-29 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal