altertable-lakehouse 0.7.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 730648db52f373495553ad9179f698b55a1bc309e5e5465a3e39733bc4659ab4
-  data.tar.gz: 0adb085fa50da366e377cb1b847273c0020ef058b871a143866b4c2d1558e106
+  metadata.gz: c92cf2b0a1bf2f44a8d3b2e7934a5b9f3399293409333cbd19e5749158272176
+  data.tar.gz: 44e709abf74aa54c03345afd11ddfb15be5aec1fff1f76722fad1d05a7c9499d
 SHA512:
-  metadata.gz: 1cde4636923e138c259a738f96d84305ff6a8aa929dc12e49f792989da2ee0a2394db20f2a37f80dcda21b304ebb7c3860122bd46b6cc4a01ca0ddadd805bc38
-  data.tar.gz: baffcdd22da74b9006f153f41b87703f93ba0351f3edcc2082576472b3ef52451656ee0bdc2afe72e79ff6835d10a1049ccc6555bc92c1bf23b82184e65cd54a
+  metadata.gz: 3a01c990cd7454973a878bf9a7835e9bf19b1795ba44209aa9d844e88188af31b36712b4fbcfa4ce7de503401bc5faaa3d266324da944f17d1f52b05de217d55
+  data.tar.gz: 75b2e70e21eec5de857922989fbbb3aee671905298dd1645e8da56d26791eb41ee29112769f03aafc08d6903d0b1f578eb7561e37bf6d3dc9095de36cf2b20a1

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-    ".": "0.7.0"
+    ".": "0.8.1"
 }

data/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file.
 
+## Unreleased
+
+### Added
+
+* Support named and positional bind values through `QueryRequest#params`.
+
+## [0.8.1](https://github.com/altertable-ai/altertable-lakehouse-ruby/compare/altertable-lakehouse/v0.8.0...altertable-lakehouse/v0.8.1) (2026-10-07)
+
+
+### Bug Fixes
+
+* **error:** implement proper query error parsing ([#54](https://github.com/altertable-ai/altertable-lakehouse-ruby/issues/54)) ([86f6512](https://github.com/altertable-ai/altertable-lakehouse-ruby/commit/86f6512cfc6c58822981d0ac4824b7479dd1f2f4))
+
+## [0.8.0](https://github.com/altertable-ai/altertable-lakehouse-ruby/compare/altertable-lakehouse/v0.7.0...altertable-lakehouse/v0.8.0) (2026-10-07)
+
+
+### Features
+
+* **query:** support bind parameters ([#52](https://github.com/altertable-ai/altertable-lakehouse-ruby/issues/52)) ([33b2fb3](https://github.com/altertable-ai/altertable-lakehouse-ruby/commit/33b2fb38d82714a344263e1d77e4552e152b9aaa))
+
 ## [0.7.0](https://github.com/altertable-ai/altertable-lakehouse-ruby/compare/altertable-lakehouse/v0.6.0...altertable-lakehouse/v0.7.0) (2026-08-26)
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    altertable-lakehouse (0.7.0)
+    altertable-lakehouse (0.8.1)
       base64
 
 GEM

data/README.md

@@ -40,7 +40,8 @@ client.append(
 
 # Query data
 result = client.query_all(
-  statement: "SELECT * FROM main.public.events LIMIT 10"
+  statement: "SELECT * FROM main.public.events WHERE age >= $min_age",
+  params: { "min_age" => 25 }
 )
 result[:rows].each { |row| puts row }
 ```

data/lib/altertable/lakehouse/client.rb

@@ -282,7 +282,7 @@ module Altertable
       include Enumerable
 
       # metadata: the stream header object (first NDJSON line)
-      # columns:  array of column name strings (second NDJSON line)
+      # columns:  array of column names or typed column descriptors (second NDJSON line)
       attr_reader :metadata, :columns
 
       def initialize(enum)
@@ -292,19 +292,29 @@ module Altertable
       end
 
       def each(&block)
-        # The real mock streams:
-        #   line 1: { "statement":…, "session_id":…, … }   (header object)
-        #   line 2: ["col1", "col2", …]                     (column names array)
-        #   line 3+: [val1, val2, …]                        (row value arrays)
-        # We zip each row array with the column names to produce a Hash.
+        # The mock streams NDJSON:
+        #   line 1: metadata object
+        #   line 2: column descriptors, or { "error": string }
+        #   line 3+: row arrays, or { "error": string }
+        # Row arrays are zipped with column names into hashes.
         line_index = 0
 
         @enum.each do |item|
+          if line_index.positive? && (message = stream_error_message(item))
+            raise QueryError.new(
+              message,
+              line_index: line_index,
+              operation: "query",
+              http_method: "POST",
+              http_path: "/query"
+            )
+          end
+
           case line_index
           when 0
             @metadata = item
           when 1
-            @columns = item
+            @columns = normalize_columns(item)
           else
             if @columns.is_a?(Array) && item.is_a?(Array)
               block.call(@columns.zip(item).to_h)
@@ -315,6 +325,28 @@ module Altertable
           line_index += 1
         end
       end
+
+      private
+
+      # A post-metadata JSON object with an `error` string is a stream failure,
+      # not column schema or a row.
+      def stream_error_message(item)
+        return unless item.is_a?(Hash)
+
+        message = item["error"]
+        message if message.is_a?(String)
+      end
+
+      # The query service emits typed column descriptors, such as
+      # { "name" => "id", "type" => "INTEGER" }. Keep the public result
+      # shape stable by exposing names and using them as row keys.
+      def normalize_columns(columns)
+        return columns unless columns.is_a?(Array)
+
+        columns.map do |column|
+          column.is_a?(Hash) && column.key?("name") ? column["name"] : column
+        end
+      end
     end
 
   end

data/lib/altertable/lakehouse/errors.rb

@@ -21,6 +21,27 @@ module Altertable
     class TimeoutError < Error; end
     class SerializationError < Error; end
     class ParseError < Error; end
+
+    # Backend-emitted `{ "error": string }` line in a /query NDJSON stream.
+    # `line_index` is the zero-based index of that line.
+    class QueryError < Error
+      attr_reader :line_index
+
+      def initialize(message, line_index:, operation: nil, http_method: nil, http_path: nil, status_code: nil, retriable: false, request_id: nil, cause: nil)
+        super(
+          message,
+          operation: operation,
+          http_method: http_method,
+          http_path: http_path,
+          status_code: status_code,
+          retriable: retriable,
+          request_id: request_id,
+          cause: cause
+        )
+        @line_index = line_index
+      end
+    end
+
     class ApiError < Error; end
     class ConfigurationError < Error; end
   end

data/lib/altertable/lakehouse/models.rb

@@ -54,9 +54,9 @@ module Altertable
       end
 
       class QueryRequest < Request
-        attr_reader :statement, :catalog, :schema, :session_id, :compute_size, :sanitize, :limit, :offset, :timezone, :ephemeral, :visible, :requested_by, :query_id, :cache
+        attr_reader :statement, :catalog, :schema, :session_id, :compute_size, :sanitize, :limit, :offset, :timezone, :ephemeral, :visible, :requested_by, :query_id, :cache, :params
 
-        def initialize(statement:, catalog: nil, schema: nil, session_id: nil, compute_size: nil, sanitize: nil, limit: nil, offset: nil, timezone: nil, ephemeral: nil, visible: nil, requested_by: nil, query_id: nil, cache: nil)
+        def initialize(statement:, catalog: nil, schema: nil, session_id: nil, compute_size: nil, sanitize: nil, limit: nil, offset: nil, timezone: nil, ephemeral: nil, visible: nil, requested_by: nil, query_id: nil, cache: nil, params: nil)
           @statement = statement
           @catalog = catalog
           @schema = schema
@@ -71,6 +71,7 @@ module Altertable
           @requested_by = requested_by
           @query_id = query_id
           @cache = cache
+          @params = params
         end
 
         def to_h
@@ -88,6 +89,7 @@ module Altertable
           h[:requested_by] = @requested_by if @requested_by
           h[:query_id] = @query_id if @query_id
           h[:cache] = @cache unless @cache.nil?
+          h[:params] = @params unless @params.nil?
           h
         end
       end

data/lib/altertable/lakehouse/version.rb

@@ -1,5 +1,5 @@
 module Altertable
   module Lakehouse
-    VERSION = "0.7.0"
+    VERSION = "0.8.1"
   end
 end

data/rbi/altertable/lakehouse.rbi

@@ -47,6 +47,27 @@ module Altertable
     class TimeoutError < Error; end
     class SerializationError < Error; end
     class ParseError < Error; end
+
+    class QueryError < Error
+      sig { returns(Integer) }
+      def line_index; end
+
+      sig do
+        params(
+          message: String,
+          line_index: Integer,
+          operation: T.nilable(String),
+          http_method: T.nilable(String),
+          http_path: T.nilable(String),
+          status_code: T.nilable(Integer),
+          retriable: T::Boolean,
+          request_id: T.nilable(String),
+          cause: T.nilable(Exception)
+        ).void
+      end
+      def initialize(message, line_index:, operation: nil, http_method: nil, http_path: nil, status_code: nil, retriable: false, request_id: nil, cause: nil); end
+    end
+
     class ApiError < Error; end
     class ConfigurationError < Error; end
 
@@ -300,6 +321,9 @@ module Altertable
         sig { returns(T.nilable(T::Boolean)) }
         def cache; end
 
+        sig { returns(T.nilable(T.any(T::Hash[String, T.untyped], T::Array[T.untyped]))) }
+        def params; end
+
         sig do
           params(
             statement: String,
@@ -315,10 +339,11 @@ module Altertable
             visible: T.nilable(T::Boolean),
             requested_by: T.nilable(String),
             query_id: T.nilable(String),
-            cache: T.nilable(T::Boolean)
+            cache: T.nilable(T::Boolean),
+            params: T.nilable(T.any(T::Hash[String, T.untyped], T::Array[T.untyped]))
           ).void
         end
-        def initialize(statement:, catalog: nil, schema: nil, session_id: nil, compute_size: nil, sanitize: nil, limit: nil, offset: nil, timezone: nil, ephemeral: nil, visible: nil, requested_by: nil, query_id: nil, cache: nil); end
+        def initialize(statement:, catalog: nil, schema: nil, session_id: nil, compute_size: nil, sanitize: nil, limit: nil, offset: nil, timezone: nil, ephemeral: nil, visible: nil, requested_by: nil, query_id: nil, cache: nil, params: nil); end
 
         sig { returns(T::Hash[Symbol, T.untyped]) }
         def to_h; end

data/sig/altertable/lakehouse/errors.rbs

@@ -39,6 +39,22 @@ module Altertable
     class ParseError < Error
     end
 
+    class QueryError < Error
+      attr_reader line_index: Integer
+
+      def initialize: (
+        String message,
+        line_index: Integer,
+        ?operation: String?,
+        ?http_method: String?,
+        ?http_path: String?,
+        ?status_code: Integer?,
+        ?retriable: bool,
+        ?request_id: String?,
+        ?cause: Exception?
+      ) -> void
+    end
+
     class ApiError < Error
     end
 

data/sig/altertable/lakehouse/models.rbs

@@ -45,6 +45,7 @@ module Altertable
         attr_reader requested_by: String?
         attr_reader query_id: String?
         attr_reader cache: bool?
+        attr_reader params: (::Hash[String, untyped] | ::Array[untyped])?
 
         def initialize: (
           statement: String,
@@ -60,7 +61,8 @@ module Altertable
           ?visible: bool?,
           ?requested_by: String?,
           ?query_id: String?,
-          ?cache: bool?
+          ?cache: bool?,
+          ?params: (::Hash[String, untyped] | ::Array[untyped])?
         ) -> void
 
         def to_h: () -> ::Hash[Symbol, untyped]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: altertable-lakehouse
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Altertable AI