altertable-lakehouse 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a603bff18558e212586e0bb27016f56c832266d7dedce34ee0a7cf5a6b820a5
-  data.tar.gz: 4203dd0b9b090439722b8f51c8ad931048689e37ab1078738b541b0644f07427
+  metadata.gz: 772e340c84023d173342bd793b0467bb830a49d10b29b8c379addacb6beb2e8d
+  data.tar.gz: e3d23d9a428aa51acd9a87abfcab1723bb62f913915bedd43a5ab043b7ed7297
 SHA512:
-  metadata.gz: 48b6b338259bdfa8ef5b65f967b76ec8ef79b48bba966eff4cd32c123c16ad94c7e3bb90d30ea09325d9b96f4313ea193f5e9bf639207f1969d0f640e869f44a
-  data.tar.gz: 3459d13102d1a68eb09aaa8cdb969d0bb0ec7157061ceb83873eea9af545e0414f4702939d693eb32bcbe8a7c4208379041cb971b02de261f735801851304895
+  metadata.gz: f6194a61779c52bb92c03267b25ef12ef560d92ca1fed2fd63bb2238ee1292ae231ec700c163130a7f93509daf974efa53eb5bf12fb0066a6abcd07d670df4bf
+  data.tar.gz: 9b576b7bee48db81ade8f27e16656adf856c97e2c965f26e8f04e8ab2952a40365febc21832acf1e080314b08798189c788cfa7424a39ad6613581a29e8af1f2

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-    ".": "0.5.1"
+    ".": "0.6.0"
 }

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.6.0](https://github.com/altertable-ai/altertable-lakehouse-ruby/compare/altertable-lakehouse/v0.5.1...altertable-lakehouse/v0.6.0) (2026-06-30)
+
+
+### Features
+
+* add configurable open timeout ([#41](https://github.com/altertable-ai/altertable-lakehouse-ruby/issues/41)) ([f568a96](https://github.com/altertable-ai/altertable-lakehouse-ruby/commit/f568a96a4fcc59dd91a622c6119779e1e9171bda))
+
+
+### Bug Fixes
+
+* **api:** expose upsert API ([#42](https://github.com/altertable-ai/altertable-lakehouse-ruby/issues/42)) ([fcda808](https://github.com/altertable-ai/altertable-lakehouse-ruby/commit/fcda808db2c52a526d848f56fa3509bdb2738310))
+
 ## [0.5.1](https://github.com/altertable-ai/altertable-lakehouse-ruby/compare/altertable-lakehouse/v0.5.0...altertable-lakehouse/v0.5.1) (2026-05-29)
 
 
@@ -66,7 +78,7 @@ All notable changes to this project will be documented in this file.
 
 ### Added
 - Initial implementation of Altertable Lakehouse Ruby Client.
-- Support for `append`, `query` (streamed/accumulated), `upload`, `validate`.
+- Support for `append`, `query` (streamed/accumulated), `upsert`, `validate`.
 - Support for `get_query`, `cancel_query`.
 - Typed request/response models.
 - Faraday-based HTTP client with retries.

data/Gemfile.lock

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

data/README.md

@@ -57,7 +57,8 @@ client = Altertable::Lakehouse::Client.new(
   username: "your_username",
   password: "your_password",
   base_url: "https://api.altertable.ai", # Optional
-  timeout: 10 # Optional
+  timeout: 10, # Optional
+  open_timeout: 5 # Optional
 )
 
 # 2. Pre-encoded Basic Auth Token
@@ -144,7 +145,7 @@ end
 
 ### `upload`
 
-Uploads a file (CSV, Parquet, etc.) to a table.
+Uploads a file (CSV, Parquet, etc.) to create, append, or overwrite a table.
 
 ```ruby
 File.open("data.csv", "rb") do |file|
@@ -152,13 +153,28 @@ File.open("data.csv", "rb") do |file|
     catalog: "main",
     schema: "public",
     table: "events",
-    format: "csv",
     mode: "append",
     file_io: file
   )
 end
 ```
 
+### `upsert`
+
+Upserts a file by matching rows on a primary key.
+
+```ruby
+File.open("updates.csv", "rb") do |file|
+  client.upsert(
+    catalog: "main",
+    schema: "public",
+    table: "events",
+    primary_key: "id",
+    file_io: file
+  )
+end
+```
+
 ### `get_query`
 
 Retrieves information about a query execution.
@@ -234,6 +250,7 @@ end
 | `basic_auth_token` | String | `ENV["ALTERTABLE_BASIC_AUTH_TOKEN"]` | Pre-encoded Basic Auth token |
 | `base_url` | String | `https://api.altertable.ai` | API base URL |
 | `timeout` | Integer | `10` | Request timeout in seconds |
+| `open_timeout` | Integer | `5` | Connection timeout in seconds |
 | `user_agent` | String | `nil` | Custom User-Agent suffix |
 
 ## License

data/lib/altertable/lakehouse/adapters.rb

@@ -4,9 +4,10 @@ module Altertable
       Response = Struct.new(:status, :body, :headers)
 
       class Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {})
           @base_url = base_url
           @timeout = timeout
+          @open_timeout = open_timeout
           @headers = headers
         end
 
@@ -24,7 +25,7 @@ module Altertable
       end
 
       class FaradayAdapter < Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {})
           super
           require "faraday"
           require "faraday/retry"
@@ -33,6 +34,7 @@ module Altertable
           @conn = Faraday.new(url: @base_url) do |f|
             @headers.each { |k, v| f.headers[k] = v }
             f.options.timeout = @timeout
+            f.options.open_timeout = @open_timeout
             f.request :retry, max: 3, interval: 0.05, backoff_factor: 2
             f.adapter Faraday.default_adapter
           end
@@ -78,13 +80,13 @@ module Altertable
       end
 
       class HttpxAdapter < Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {})
           super
           require "httpx"
           # Configure retries plugin if available or implement manual retries?
           # Httpx has built-in retries via plugin.
           @client = HTTPX.plugin(:retries).with(
-            timeout: { operation_timeout: @timeout },
+            timeout: { operation_timeout: @timeout, connect_timeout: @open_timeout },
             headers: @headers,
             base_url: @base_url
           )
@@ -133,7 +135,7 @@ module Altertable
       end
 
       class NetHttpAdapter < Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {})
           super
           require "net/http"
           require "uri"
@@ -164,7 +166,7 @@ module Altertable
           req.body = body if body
 
           # Net::HTTP start
-          Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https", open_timeout: @timeout, read_timeout: @timeout) do |http|
+          Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https", open_timeout: @open_timeout, read_timeout: @timeout) do |http|
             if block_given?
               http.request(req) do |response|
                 # Stream the body if block is given

data/lib/altertable/lakehouse/client.rb

@@ -10,8 +10,9 @@ module Altertable
     class Client
       DEFAULT_BASE_URL = "https://api.altertable.ai"
       DEFAULT_TIMEOUT = 10
+      DEFAULT_OPEN_TIMEOUT = 5
 
-      def initialize(username: nil, password: nil, basic_auth_token: nil, base_url: nil, timeout: nil, user_agent: nil, adapter: nil, headers: {})
+      def initialize(username: nil, password: nil, basic_auth_token: nil, base_url: nil, timeout: nil, open_timeout: nil, user_agent: nil, adapter: nil, headers: {})
         # 1. Try passed basic_auth_token
         # 2. Try passed username/password
         # 3. Try ENV["ALTERTABLE_BASIC_AUTH_TOKEN"]
@@ -31,15 +32,15 @@ module Altertable
 
         @base_url = base_url || DEFAULT_BASE_URL
         @timeout = timeout || DEFAULT_TIMEOUT
+        @open_timeout = open_timeout || DEFAULT_OPEN_TIMEOUT
         @user_agent = user_agent ? "AltertableRuby/#{VERSION} #{user_agent}" : "AltertableRuby/#{VERSION}"
         
         default_headers = {
           "Authorization" => @auth_header,
-          "User-Agent" => @user_agent,
-          "Content-Type" => "application/json"
+          "User-Agent" => @user_agent
         }
 
-        @adapter = select_adapter(adapter, base_url: @base_url, timeout: @timeout, headers: default_headers.merge(headers))
+        @adapter = select_adapter(adapter, base_url: @base_url, timeout: @timeout, open_timeout: @open_timeout, headers: default_headers.merge(headers))
       end
 
       # POST /append
@@ -65,7 +66,7 @@ module Altertable
           buffer = ""
           
           # Use adapter's stream capability
-          resp = @adapter.post("/query", body: req_body, headers: headers) do |chunk, _|
+          resp = @adapter.post("/query", body: req_body, headers: json_headers(headers)) do |chunk, _|
             buffer << chunk
           end
 
@@ -87,19 +88,32 @@ module Altertable
       end
 
       # POST /upload
-      def upload(catalog:, schema:, table:, format:, mode:, file_io:, primary_key: nil, headers: {})
+      def upload(catalog:, schema:, table:, mode:, file_io:, headers: {})
         params = {
           catalog: catalog,
           schema: schema,
           table: table,
-          format: format,
           mode: mode
         }
-        params[:primary_key] = primary_key if primary_key
 
         body = file_io.respond_to?(:read) ? file_io.read : file_io
 
-        resp = @adapter.post("/upload", body: body, params: params, headers: headers.merge("Content-Type" => "application/octet-stream"))
+        resp = @adapter.post("/upload", body: body, params: params, headers: headers)
+        handle_response(resp)
+      end
+
+      # POST /upsert
+      def upsert(catalog:, schema:, table:, primary_key:, file_io:, headers: {})
+        params = {
+          catalog: catalog,
+          schema: schema,
+          table: table,
+          primary_key: primary_key
+        }
+
+        body = file_io.respond_to?(:read) ? file_io.read : file_io
+
+        resp = @adapter.post("/upsert", body: body, params: params, headers: headers)
         handle_response(resp)
       end
 
@@ -187,11 +201,15 @@ module Altertable
           method, path,
           body: encode_request_body(body),
           params: query || {},
-          headers: headers
+          headers: body.nil? ? headers : json_headers(headers)
         )
         handle_response(resp)
       end
 
+      def json_headers(headers)
+        { "Content-Type" => "application/json" }.merge(headers)
+      end
+
       def encode_request_body(body)
         case body
         when Hash, Array

data/lib/altertable/lakehouse/version.rb

@@ -1,5 +1,5 @@
 module Altertable
   module Lakehouse
-    VERSION = "0.5.1"
+    VERSION = "0.6.0"
   end
 end

data/rbi/altertable/lakehouse.rbi

@@ -53,6 +53,7 @@ module Altertable
     class Client
       DEFAULT_BASE_URL = T.let(T.unsafe(nil), String)
       DEFAULT_TIMEOUT = T.let(T.unsafe(nil), Integer)
+      DEFAULT_OPEN_TIMEOUT = T.let(T.unsafe(nil), Integer)
 
       sig do
         params(
@@ -61,12 +62,13 @@ module Altertable
           basic_auth_token: T.nilable(String),
           base_url: T.nilable(String),
           timeout: T.nilable(T.any(Integer, Float)),
+          open_timeout: T.nilable(T.any(Integer, Float)),
           user_agent: T.nilable(String),
           adapter: T.nilable(Symbol),
           headers: T::Hash[String, String]
         ).void
       end
-      def initialize(username: nil, password: nil, basic_auth_token: nil, base_url: nil, timeout: nil, user_agent: nil, adapter: nil, headers: {}); end
+      def initialize(username: nil, password: nil, basic_auth_token: nil, base_url: nil, timeout: nil, open_timeout: nil, user_agent: nil, adapter: nil, headers: {}); end
 
       sig do
         params(
@@ -94,14 +96,24 @@ module Altertable
           catalog: String,
           schema: String,
           table: String,
-          format: String,
           mode: String,
           file_io: T.untyped,
-          primary_key: T.nilable(String),
           headers: T::Hash[String, String]
         ).returns(T.untyped)
       end
-      def upload(catalog:, schema:, table:, format:, mode:, file_io:, primary_key: nil, headers: {}); end
+      def upload(catalog:, schema:, table:, mode:, file_io:, headers: {}); end
+
+      sig do
+        params(
+          catalog: String,
+          schema: String,
+          table: String,
+          primary_key: String,
+          file_io: T.untyped,
+          headers: T::Hash[String, String]
+        ).returns(T.untyped)
+      end
+      def upsert(catalog:, schema:, table:, primary_key:, file_io:, headers: {}); end
 
       sig { params(query_id: String, headers: T::Hash[String, String]).returns(::Altertable::Lakehouse::Models::QueryLogResponse) }
       def get_query(query_id, headers: {}); end
@@ -664,8 +676,8 @@ module Altertable
       end
 
       class Base
-        sig { params(base_url: String, timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
-        def initialize(base_url:, timeout:, headers: {}); end
+        sig { params(base_url: String, timeout: T.any(Integer, Float), open_timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}); end
 
         sig do
           params(
@@ -702,8 +714,8 @@ module Altertable
       end
 
       class FaradayAdapter < Base
-        sig { params(base_url: String, timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
-        def initialize(base_url:, timeout:, headers: {}); end
+        sig { params(base_url: String, timeout: T.any(Integer, Float), open_timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}); end
 
         sig do
           params(
@@ -745,8 +757,8 @@ module Altertable
       end
 
       class HttpxAdapter < Base
-        sig { params(base_url: String, timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
-        def initialize(base_url:, timeout:, headers: {}); end
+        sig { params(base_url: String, timeout: T.any(Integer, Float), open_timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}); end
 
         sig do
           params(
@@ -788,8 +800,8 @@ module Altertable
       end
 
       class NetHttpAdapter < Base
-        sig { params(base_url: String, timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
-        def initialize(base_url:, timeout:, headers: {}); end
+        sig { params(base_url: String, timeout: T.any(Integer, Float), open_timeout: T.any(Integer, Float), headers: T::Hash[String, String]).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}); end
 
         sig do
           params(

data/sig/altertable/lakehouse/adapters.rbs

@@ -12,9 +12,10 @@ module Altertable
       class Base
         @base_url: String
         @timeout: Integer | Float
+        @open_timeout: Integer | Float
         @headers: ::Hash[String, String]
 
-        def initialize: (base_url: String, timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
+        def initialize: (base_url: String, timeout: Integer | Float, open_timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
         def get: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def post: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def delete: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
@@ -23,7 +24,7 @@ module Altertable
       class FaradayAdapter < Base
         @conn: untyped
 
-        def initialize: (base_url: String, timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
+        def initialize: (base_url: String, timeout: Integer | Float, open_timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
         def get: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def post: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def delete: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
@@ -36,7 +37,7 @@ module Altertable
       class HttpxAdapter < Base
         @client: untyped
 
-        def initialize: (base_url: String, timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
+        def initialize: (base_url: String, timeout: Integer | Float, open_timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
         def get: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def post: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def delete: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
@@ -49,7 +50,7 @@ module Altertable
       class NetHttpAdapter < Base
         @uri: URI::HTTP | URI::HTTPS
 
-        def initialize: (base_url: String, timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
+        def initialize: (base_url: String, timeout: Integer | Float, open_timeout: Integer | Float, ?headers: ::Hash[String, String]) -> void
         def get: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def post: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response
         def delete: (String path, ?body: String?, ?params: ::Hash[Symbol | String, untyped], ?headers: ::Hash[String, String]) -> Response

data/sig/altertable/lakehouse/client.rbs

@@ -4,11 +4,13 @@ module Altertable
       @auth_header: String
       @base_url: String
       @timeout: Integer | Float
+      @open_timeout: Integer | Float
       @user_agent: String
       @adapter: untyped
 
       DEFAULT_BASE_URL: String
       DEFAULT_TIMEOUT: Integer
+      DEFAULT_OPEN_TIMEOUT: Integer
 
       def initialize: (
         ?username: String?,
@@ -16,6 +18,7 @@ module Altertable
         ?basic_auth_token: String?,
         ?base_url: String?,
         ?timeout: Integer | Float?,
+        ?open_timeout: Integer | Float?,
         ?user_agent: String?,
         ?adapter: Symbol?,
         ?headers: ::Hash[String, String]
@@ -40,10 +43,17 @@ module Altertable
         catalog: String,
         schema: String,
         table: String,
-        format: String,
         mode: String,
         file_io: untyped,
-        ?primary_key: String?,
+        ?headers: ::Hash[String, String]
+      ) -> untyped
+
+      def upsert: (
+        catalog: String,
+        schema: String,
+        table: String,
+        primary_key: String,
+        file_io: untyped,
         ?headers: ::Hash[String, String]
       ) -> untyped
 

metadata

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