altertable-lakehouse 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a603bff18558e212586e0bb27016f56c832266d7dedce34ee0a7cf5a6b820a5
-  data.tar.gz: 4203dd0b9b090439722b8f51c8ad931048689e37ab1078738b541b0644f07427
+  metadata.gz: 730648db52f373495553ad9179f698b55a1bc309e5e5465a3e39733bc4659ab4
+  data.tar.gz: 0adb085fa50da366e377cb1b847273c0020ef058b871a143866b4c2d1558e106
 SHA512:
-  metadata.gz: 48b6b338259bdfa8ef5b65f967b76ec8ef79b48bba966eff4cd32c123c16ad94c7e3bb90d30ea09325d9b96f4313ea193f5e9bf639207f1969d0f640e869f44a
-  data.tar.gz: 3459d13102d1a68eb09aaa8cdb969d0bb0ec7157061ceb83873eea9af545e0414f4702939d693eb32bcbe8a7c4208379041cb971b02de261f735801851304895
+  metadata.gz: 1cde4636923e138c259a738f96d84305ff6a8aa929dc12e49f792989da2ee0a2394db20f2a37f80dcda21b304ebb7c3860122bd46b6cc4a01ca0ddadd805bc38
+  data.tar.gz: baffcdd22da74b9006f153f41b87703f93ba0351f3edcc2082576472b3ef52451656ee0bdc2afe72e79ff6835d10a1049ccc6555bc92c1bf23b82184e65cd54a

data/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [altertable-ai]

data/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -37,7 +37,7 @@ body:
   - type: input
     id: runtime
     attributes:
-      label: "{language} Version"
+      label: "Ruby Version"
     validations:
       required: true
   - type: dropdown

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## What
+
+<!-- What does this PR do? One sentence is fine. -->
+
+## Why
+
+<!-- Link an issue or explain the motivation. -->
+
+## Checklist
+
+- [ ] Tests added or updated
+- [ ] `CHANGELOG.md` updated (skip for docs/CI-only changes)
+- [ ] Breaking change noted in commit footer (`BREAKING CHANGE: …`) and changelog

data/.github/workflows/ci.yml

@@ -6,7 +6,7 @@ on:
   pull_request: {}
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
         ruby-version: ["3.2", "3.3", "3.4", "4.0"]
@@ -26,12 +26,12 @@ jobs:
           --health-start-period 10s
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
         with:
           submodules: recursive
 
       - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
@@ -40,11 +40,11 @@ jobs:
         run: bundle exec rake spec
 
   lint:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
       - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1
         with:
           ruby-version: "3.4"
           bundler-cache: true
@@ -53,11 +53,11 @@ jobs:
 
   typing:
     name: "Typing"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
       - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1
         with:
           ruby-version: "3.4"
           bundler-cache: true

data/.github/workflows/release-please.yml

@@ -7,14 +7,14 @@ on:
 
 jobs:
   check:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     permissions:
       contents: write
       pull-requests: write
 
     steps:
-      - uses: googleapis/release-please-action@v4
+      - uses: googleapis/release-please-action@8b8fd2cc23b2e18957157a9d923d75aa0c6f6ad5 # v4
         id: release
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -29,7 +29,7 @@ jobs:
 
     if: ${{ needs.check.outputs.release_created }}
 
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     permissions:
       contents: write
@@ -37,11 +37,11 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
         with:
           persist-credentials: false
-      - uses: ruby/setup-ruby@v1
+      - uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1
         with:
           ruby-version: 3.4
           bundler-cache: true
-      - uses: rubygems/release-gem@v1
+      - uses: rubygems/release-gem@052cc82692552de3ef2b81fd670e41d13cba8092 # v1

data/.github/workflows/semantic-pr.yml

@@ -0,0 +1,34 @@
+name: Semantic Pull Request
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - synchronize
+
+permissions:
+  pull-requests: read
+
+jobs:
+  semantic-pr:
+    name: Validate PR title
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Validate title
+        uses: amannn/action-semantic-pull-request@e32d7e603df1aa1ba07e981f2a23455dee596825 # v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            perf
+            revert
+            docs
+            style
+            chore
+            refactor
+            test
+            build
+            ci

data/.github/workflows/semantic-pull-request.yml

@@ -1,4 +1,5 @@
 name: Semantic Pull Request
+
 on:
   pull_request_target:
     types:
@@ -6,12 +7,21 @@ on:
       - edited
       - synchronize
 
+permissions:
+  pull-requests: read
+
+concurrency:
+  group: semantic-pr-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
 jobs:
   main:
     name: Validate PR title
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
     steps:
-      - uses: amannn/action-semantic-pull-request@v5
+      - name: Validate pull request title
+        uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:

data/.release-please-manifest.json

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

data/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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)
+
+
+### Features
+
+* pass proxy through as a raw options override ([#50](https://github.com/altertable-ai/altertable-lakehouse-ruby/issues/50)) ([f2af534](https://github.com/altertable-ai/altertable-lakehouse-ruby/commit/f2af53452b42b8421f6529d532e23546ffe80c16))
+
+## [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 +85,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/CODE_OF_CONDUCT.md

@@ -70,14 +70,14 @@ Community leaders will follow these Community Impact Guidelines in determining t
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct/][v2.1].
 
 Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder][Mozilla CoC].
 
-For answers to common questions about this code of conduct, see the FAQ at [https://www.contributor-covenant.org/faq][FAQ]. Translations are available at [https://www.contributor-covenant.org/translations][translations].
+For answers to common questions about this code of conduct, see the FAQ at [https://www.contributor-covenant.org/faq/][FAQ]. Translations are available at [https://www.contributor-covenant.org/translations/][translations].
 
 [homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct/
+[Mozilla CoC]: https://github.com/mozilla/inclusion
+[FAQ]: https://www.contributor-covenant.org/faq/
+[translations]: https://www.contributor-covenant.org/translations/

data/CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to altertable-lakehouse-ruby
+# Contributing to altertable-lakehouse
 
 ## Development Setup
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    altertable-lakehouse (0.5.1)
+    altertable-lakehouse (0.7.0)
       base64
 
 GEM
@@ -108,6 +108,8 @@ GEM
       rexml (>= 3.2.6)
       sorbet-static-and-runtime (>= 0.5.10187)
       thor (>= 0.19.2)
+    stub_env (1.0.4)
+      rspec (>= 2.0, < 4.0)
     tapioca (0.17.7)
       benchmark
       bundler (>= 2.2.25)
@@ -150,6 +152,7 @@ DEPENDENCIES
   rubocop (~> 1.50)
   sorbet
   sorbet-runtime
+  stub_env
   tapioca
   testcontainers
 

data/README.md

@@ -57,7 +57,9 @@ 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
+  proxy: nil # Optional; omit to honor HTTP(S)_PROXY, or pass nil/a custom proxy URL to override
 )
 
 # 2. Pre-encoded Basic Auth Token
@@ -144,7 +146,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 +154,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 +251,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/SECURITY.md

@@ -8,7 +8,7 @@ Only the latest minor release receives security patches.
 
 **Do not open a public issue.**
 
-Email security@altertable.ai with:
+Email <security@altertable.ai> with:
 
 1. Description of the vulnerability
 2. Steps to reproduce

data/altertable-lakehouse.gemspec

@@ -34,6 +34,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "rubocop", "~> 1.50"
+  spec.add_development_dependency "stub_env"
   spec.add_development_dependency "testcontainers"
   spec.add_development_dependency "rbs"
   spec.add_development_dependency "sorbet"

data/lib/altertable/lakehouse/adapters.rb

@@ -4,10 +4,12 @@ module Altertable
       Response = Struct.new(:status, :body, :headers)
 
       class Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options)
           @base_url = base_url
           @timeout = timeout
+          @open_timeout = open_timeout
           @headers = headers
+          @options = options
         end
 
         def get(path, body: nil, params: {}, headers: {}, &_block)
@@ -24,16 +26,18 @@ module Altertable
       end
 
       class FaradayAdapter < Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options)
           super
           require "faraday"
           require "faraday/retry"
           require "faraday/net_http"
-          
+
           @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.proxy = options[:proxy] if options.key?(:proxy)
             f.adapter Faraday.default_adapter
           end
         end
@@ -78,16 +82,18 @@ module Altertable
       end
 
       class HttpxAdapter < Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options)
           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 },
+          http_options = {
+            timeout: { operation_timeout: @timeout, connect_timeout: @open_timeout },
             headers: @headers,
             base_url: @base_url
-          )
+          }
+          http_options[:proxy] = options[:proxy] if options.key?(:proxy)
+          @client = HTTPX.plugin(:retries).with(**http_options)
         end
 
         def get(path, body: nil, params: {}, headers: {}, &_block) # rubocop:disable Lint/UnusedMethodArgument
@@ -133,7 +139,7 @@ module Altertable
       end
 
       class NetHttpAdapter < Base
-        def initialize(base_url:, timeout:, headers: {})
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options)
           super
           require "net/http"
           require "uri"
@@ -164,7 +170,9 @@ 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|
+          start_args = [uri.host, uri.port]
+          start_args << @options[:proxy] if @options.key?(:proxy)
+          Net::HTTP.start(*start_args, 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: {}, **options)
         # 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), **options)
       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.7.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,14 @@ 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]
+          headers: T::Hash[String, String],
+          options: T.untyped
         ).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: {}, **options); end
 
       sig do
         params(
@@ -94,14 +97,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 +677,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], options: T.untyped).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options); end
 
         sig do
           params(
@@ -702,8 +715,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], options: T.untyped).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options); end
 
         sig do
           params(
@@ -745,8 +758,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], options: T.untyped).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options); end
 
         sig do
           params(
@@ -788,8 +801,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], options: T.untyped).void }
+        def initialize(base_url:, timeout:, open_timeout:, headers: {}, **options); end
 
         sig do
           params(

data/sig/altertable/lakehouse/adapters.rbs

@@ -12,9 +12,11 @@ module Altertable
       class Base
         @base_url: String
         @timeout: Integer | Float
+        @open_timeout: Integer | Float
         @headers: ::Hash[String, String]
+        @options: ::Hash[Symbol, 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], **untyped options) -> 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 +25,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], **untyped options) -> 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 +38,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], **untyped options) -> 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 +51,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], **untyped options) -> 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,9 +18,11 @@ 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]
+        ?headers: ::Hash[String, String],
+        **untyped options
       ) -> void
 
       def append: (
@@ -40,10 +44,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.7.0
 platform: ruby
 authors:
 - Altertable AI
@@ -121,6 +121,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: stub_env
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: testcontainers
   requirement: !ruby/object:Gem::Requirement
@@ -184,10 +198,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/FUNDING.yml"
 - ".github/ISSUE_TEMPLATE/bug_report.yml"
 - ".github/ISSUE_TEMPLATE/feature_request.yml"
+- ".github/PULL_REQUEST_TEMPLATE.md"
 - ".github/workflows/ci.yml"
 - ".github/workflows/release-please.yml"
+- ".github/workflows/semantic-pr.yml"
 - ".github/workflows/semantic-pull-request.yml"
 - ".gitignore"
 - ".gitmodules"