questdb 0.1.0-x86_64-linux-gnu → 0.1.1-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 552b130661804f60d094bdbc1cdcabfd24c06e26c08c6aa740b3e9af0e32e5b1
-  data.tar.gz: 642ac1943fc3d7e280e771b3853b0ad64dfce9a27c0a94b4eb7cbc85b174dec1
+  metadata.gz: 86d98cff01dab0521da8aa8be968dab6b2b990452b2a4b2beca80b23687b6eea
+  data.tar.gz: 92ea4d60de2dbafdc31cb0cb346822a51b1d9ea0defe01d7f3192eaae6878b07
 SHA512:
-  metadata.gz: 543c087ac0505a2cc2f5496152c7c53729867b09de9f4b25b0ed234204cc4047112f8cb572bbe7ea8700452774c84bae42c101c277fe02bd190f405a43a20e02
-  data.tar.gz: 88c31e5c3bdfbb0ce431fed1a22cb9a81a77bfca64053b9ee845111e53e91b3a969820db0592ef3b3178c19224b7cb0934d0de27bae576deec8b2338d95bbd73
+  metadata.gz: 8936786af5a14b87096c17968e47467f90dc368df8ab086a34ce339899e69ce555b329f5c6cf82b6d1844e8e5544444de6d8bff30c0c7f3c54a438d636cd9f77
+  data.tar.gz: e31d326d70450569cd8d1fdcfe3b78bc4e89d247557af3972705a287abfd9227de3891f1b777984f90719ab557ce33d91c077426e9a29d3862d4160efd644718

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.1.1 (2026-10-21)
+
+- Fixed precompiled gems that installed but failed on `require "questdb"`. The 0.1.0 native extensions were linked against the Ruby on the build machine: macOS gems referenced that machine's `libruby` path (or, for Ruby 3.1 on ARM64, symbols in its `ruby` executable), and Linux gems required `libruby.so`, so they failed with Rubies built without a shared library. Extensions now resolve Ruby's C API from the Ruby that loads them. The release pipeline checks every extension's linkage, because install tests on the build machines cannot detect this.
+- Fixed `ack: :durable` without `request_durable_ack` enabled: `ingest_columns`, `ingest_arrow`, `flush(wait: true)`, and `wait` now raise `:invalid_api_call` before sending anything. Previously direct ingestion committed its rows and then raised an in-doubt error.
+- Updated to `c-questdb-client` 7.2.0. The `query_timeout_ms` connect-string key sets a client-side timeout for queries on servers that support it; an expired query raises `QuestDB::Error` with code `:query_timeout`. Standalone WebSocket flushes now check the full frame-size limit before writing anything.
+- Known issue: `c-questdb-client` 7.2.0 still locks rustls 0.23.41, rustls-webpki 0.103.13 and webpki-roots 1.0.8. In addition to the four rustls advisories listed for 0.1.0, RUSTSEC-2026-0381 (webpki-roots) and RUSTSEC-2026-0382 (rustls-webpki), both about trusting distrusted certificate intermediates, are temporarily ignored in `cargo audit` (`.cargo/audit.toml`) until a `c-questdb-client` patch release updates these crates.
+
 ## 0.1.0 (2026-10-19)
 
 Initial pre-1.0 release for early adopters. Public APIs may evolve before 1.0; delivery and acknowledgement semantics are intentional compatibility commitments and changes will be documented here.

data/README.md

@@ -1,6 +1,6 @@
 # QuestDB Ruby client
 
-`questdb` is an MRI Ruby client for QuestDB's native **QuestDB Wire Protocol (QWP)** over WebSocket. It is backed by the official `c-questdb-client` 7.1.0 C ABI and does not implement the protocol, networking, TLS, authentication, failover, or store-and-forward in Ruby.
+`questdb` is an MRI Ruby client for QuestDB's native **QuestDB Wire Protocol (QWP)** over WebSocket. It is backed by the official `c-questdb-client` 7.2.0 C ABI and does not implement the protocol, networking, TLS, authentication, failover, or store-and-forward in Ruby.
 
 The client provides a deployment-level connection pool, pooled row and direct columnar ingestion, streaming SQL queries, safe Ruby dispatch for lifecycle/rejection callbacks, and standalone QWP WebSocket senders. Query batches and callback values are copied into ordinary Ruby objects before borrowed native data expires. Legacy ILP transports are intentionally not part of this client.
 

data/THIRD_PARTY_NOTICES.md

@@ -130,8 +130,8 @@ powerfmt | 0.2.0 | MIT OR Apache-2.0
 ppv-lite86 | 0.2.21 | MIT OR Apache-2.0
 proc-macro2 | 1.0.106 | MIT OR Apache-2.0
 questdb-confstr | 0.1.1 | Apache-2.0
-questdb-rs | 7.1.0 | Apache-2.0
-questdb-rs-ffi | 7.1.0 | Apache-2.0 (upstream workspace license)
+questdb-rs | 7.2.0 | Apache-2.0
+questdb-rs-ffi | 7.2.0 | Apache-2.0 (upstream workspace license)
 quote | 1.0.46 | MIT OR Apache-2.0
 r-efi | 5.3.0 | MIT OR Apache-2.0 OR LGPL-2.1-or-later
 r-efi | 6.0.0 | MIT OR Apache-2.0 OR LGPL-2.1-or-later

data/docs/configuration.md

@@ -20,15 +20,16 @@ The Ruby-only keywords `connection_listener`, `error_handler`, `connection_event
 
 ## Native settings
 
-Settings are passed directly to `c-questdb-client` 7.1.0 so new native settings do not require a Ruby release. Important groups include:
+Settings are passed directly to `c-questdb-client` 7.2.0 so new native settings do not require a Ruby release. Important groups include:
 
 - pool: `sender_pool_min`, `sender_pool_max`, `query_pool_min`, `query_pool_max`, `acquire_timeout_ms`, `idle_timeout_ms`, `pool_reap`, `lazy_connect`;
 - reconnect/failover: `addr` (comma-separated endpoints), `target`, `zone`, `reconnect_initial_backoff_millis`, `reconnect_max_backoff_millis`, `reconnect_max_duration_millis`, `initial_connect_retry`;
 - store-and-forward: `sf_dir`, `sender_id`, `sf_max_segment_bytes`, `sf_max_total_bytes`, `sf_append_deadline_millis`, `sf_durability`, `sf_sync_interval_millis`, `drain_orphans`, `max_background_drainers`;
 - delivery: `request_durable_ack`, `close_flush_timeout_millis`, `max_buf_size`, `max_name_len`, `error_inbox_capacity`;
+- query: `query_timeout_ms` (expiry raises `:query_timeout`; servers without per-query timeout support reject queries with `:unsupported_server`);
 - authentication/TLS: `username`, `password`, `token`, `auth_timeout_ms`, `tls_verify`, `tls_ca`, `tls_roots`, `tls_roots_password`.
 
-Consult the matching upstream 7.1.0 connect-string reference for exact constraints. Unknown or invalid settings are rejected by the native parser.
+Consult the matching upstream 7.2.0 connect-string reference for exact constraints. Unknown or invalid settings are rejected by the native parser.
 
 Direct column ingestion borrows from the native direct sender pool and uses `acquire_timeout_ms`; initial direct connection retry is bounded by `reconnect_max_duration_millis`. `max_rows_per_batch` is a method argument rather than a connection setting. Direct writes do not use `sf_dir`, do not produce FSNs, and are unaffected by row auto-publish thresholds. `ack: :durable` still requires both `request_durable_ack=on` and server support.
 

data/docs/design.md

@@ -2,7 +2,7 @@
 
 ## Native boundary
 
-The gem links statically to official `c-questdb-client` 7.1.0. Ruby owns thin typed-data wrappers for:
+The gem links statically to official `c-questdb-client` 7.2.0. Ruby owns thin typed-data wrappers for:
 
 - one ref-counted `questdb_db` pool state;
 - short-lived borrowed `qwp_sender` leases;

data/docs/python-parity.md

@@ -1,6 +1,6 @@
 # Python QWP parity
 
-This client tracks the QWP surface of the QuestDB Python 5.0 client at the `c-questdb-client` 7.1.0 ABI boundary. Parity means equivalent delivery, lifecycle, type, and error semantics expressed idiomatically in Ruby; it does not mean retaining Python's legacy ILP APIs.
+This client tracks the QWP surface of the QuestDB Python 5.0 client at the `c-questdb-client` 7.2.0 ABI boundary. Parity means equivalent delivery, lifecycle, type, and error semantics expressed idiomatically in Ruby; it does not mean retaining Python's legacy ILP APIs.
 
 | Python QWP capability | Ruby API | Status |
 | --- | --- | --- |

data/docs/releasing.md

@@ -17,7 +17,7 @@ The versioned layout is required because MRI's native ABI and `libruby` soname m
 
 1. Update `QuestDB::Ingress::VERSION` and change the changelog heading from `unreleased` to the intended release date.
 2. Build from a clean candidate commit with recursively initialized submodules on approved QuestDB infrastructure.
-3. Require Ruby and Rust dependency audits to pass without ignored advisories. Temporary exception for 0.1.0: the rustls advisories listed in `.cargo/audit.toml` are ignored until a patch release moves `c-questdb-client` to rustls 0.23.46 or newer; remove each ignore as soon as its fix ships. Enterprise-only durable-ACK qualification remains optional, matching the Python client's policy.
+3. Require Ruby and Rust dependency audits to pass without ignored advisories. Temporary exception for 0.1.x on `c-questdb-client` 7.1.0 and 7.2.0: the rustls, rustls-webpki and webpki-roots advisories listed in `.cargo/audit.toml` are ignored until a patch release moves `c-questdb-client` to rustls 0.23.46, rustls-webpki 0.103.16 and webpki-roots 1.0.10 or newer; remove each ignore as soon as its fix ships. Enterprise-only durable-ACK qualification remains optional, matching the Python client's policy.
 4. Run unit, integration, Arrow, native-memory, package, and bounded fault qualification. Shared-host benchmark results remain informational.
 5. Produce all eight gems, then run `script/verify-gem` on each final file and inspect native linkage. Clean-install each native gem on MRI 3.1, 3.2, 3.3, and 3.4 on its matching platform.
 6. Confirm the source gem installs with `CARGO_NET_OFFLINE=true` in a clean `GEM_HOME` and contains no generated extension or nested QuestDB server source.

data/lib/questdb/arrow.rb

@@ -170,6 +170,7 @@ module QuestDB
       checkpoint_batches = Integer(checkpoint_batches)
       raise ArgumentError, "checkpoint_batches must be positive" unless checkpoint_batches.positive?
       @mutex.synchronize { ensure_open! }
+      ensure_durable_ack!(ack_level)
       Arrow.with_stream(source) do |capsule|
         @native.ingest_arrow(
           capsule, table, at_kind, at_value, overrides, ack_level, checkpoint_batches
@@ -201,6 +202,7 @@ module QuestDB
       checkpoint_batches = Integer(checkpoint_batches)
       raise ArgumentError, "checkpoint_batches must be positive" unless checkpoint_batches.positive?
       ensure_ws!
+      ensure_durable_ack!(ack_level)
       Arrow.with_stream(source) do |capsule|
         @native.ingest_arrow(
           @configuration, capsule, table, at_kind, at_value,

data/lib/questdb/client.rb

@@ -84,6 +84,7 @@ module QuestDB
       error_capacity = validate_capacity!(error_event_inbox_capacity, "error_event_inbox_capacity")
       parsed_settings = effective_settings || Config.parse(configuration)
       @auto_flush = parse_auto_flush(parsed_settings)
+      @durable_ack_requested = Config.durable_ack_requested?(parsed_settings)
       @mutex = Mutex.new
       @native = Ingress::Native::Client.new(
         configuration, !connection_listener.nil?, connection_capacity,
@@ -160,6 +161,7 @@ module QuestDB
         ack: ack
       )
       @mutex.synchronize { ensure_open! }
+      ensure_durable_ack!(prepared[6])
       return self if prepared[4].zero?
 
       @native.ingest_columns(*prepared)
@@ -249,6 +251,10 @@ module QuestDB
       end
     end
 
+    def ensure_durable_ack!(ack_level)
+      Config.ensure_durable_ack!(@durable_ack_requested, ack_level, PooledSender::ACK_LEVELS[:durable])
+    end
+
     def ensure_open!
       raise Ingress::IngressError.new("client is closed", code: :invalid_api_call) if closed?
     end

data/lib/questdb/config.rb

@@ -117,6 +117,25 @@ module QuestDB
       parts
     end
 
+    # Whether request_durable_ack asks for durable ACKs. Only the absent and
+    # explicit off values are recognised, so future tier values pass through
+    # to the native client unchanged.
+    def durable_ack_requested?(settings)
+      value = settings["request_durable_ack"]
+      !value.nil? && !value.to_s.strip.match?(/\A(?:off|false)\z/i)
+    end
+
+    # Fails before anything is sent when ack: :durable can never succeed,
+    # instead of after a direct batch or a row frame was already published.
+    def ensure_durable_ack!(requested, ack_level, durable_level)
+      return if requested || ack_level != durable_level
+
+      raise Ingress::IngressError.new(
+        "ack: :durable requires request_durable_ack=on in the configuration; nothing was sent",
+        code: :invalid_api_call
+      )
+    end
+
     def setting_value(value, key = nil)
       if key&.to_sym == :tls_verify && value == false
         "unsafe_off"

data/lib/questdb/pooled_sender.rb

@@ -61,6 +61,7 @@ module QuestDB
       ensure_open!
       level = normalize_ack(ack)
       raise ArgumentError, "ack: :durable requires wait: true" if level == ACK_LEVELS[:durable] && !wait
+      @client.send(:ensure_durable_ack!, level)
       return self if empty? && !wait
       @native.flush(@buffer.send(:native), !!wait, level)
       @batch_started = nil if @buffer.empty?
@@ -70,7 +71,9 @@ module QuestDB
     def wait(timeout_millis: 0, ack: :ok)
       ensure_open!
       timeout = non_negative_integer(timeout_millis, "timeout_millis")
-      @native.wait(normalize_ack(ack), timeout)
+      level = normalize_ack(ack)
+      @client.send(:ensure_durable_ack!, level)
+      @native.wait(level, timeout)
       self
     end
 

data/lib/questdb/sender.rb

@@ -121,6 +121,7 @@ module QuestDB
         max_rows_per_batch: max_rows_per_batch, ack: ack
       )
       ensure_ws!
+      ensure_durable_ack!(prepared[6])
       return self if prepared[4].zero?
       @native.ingest_columns(@configuration, *prepared)
       self
@@ -142,6 +143,7 @@ module QuestDB
       raise ArgumentError, "clear: false requires an explicit buffer" if target.equal?(@buffer) && !clear
       level = normalize_ack(ack)
       raise ArgumentError, "ack: :durable requires wait: true" if level == ACK_LEVELS[:durable] && !wait
+      ensure_durable_ack!(level)
       return self if target.empty? && !wait
       @native.flush(target.send(:native), !clear)
       @native.wait(level, 0) if wait
@@ -151,7 +153,9 @@ module QuestDB
 
     def wait(timeout_millis: 0, ack: :ok)
       ensure_ws!
-      @native.wait(normalize_ack(ack), non_negative_integer(timeout_millis, "timeout_millis"))
+      level = normalize_ack(ack)
+      ensure_durable_ack!(level)
+      @native.wait(level, non_negative_integer(timeout_millis, "timeout_millis"))
       self
     end
 
@@ -339,6 +343,7 @@ module QuestDB
       @dispatcher_threads = []
       @native = @buffer = nil
       @closed = false
+      @durable_ack_requested = Config.durable_ack_requested?(settings)
       @init_buf_size = Integer(settings.fetch("init_buf_size", 65_536))
       raise ArgumentError, "init_buf_size must be nonnegative" if @init_buf_size.negative?
       raise RangeError, "init_buf_size exceeds 100 MiB" if @init_buf_size > Ingress::Buffer::MAX_PREALLOCATE_BYTES
@@ -394,6 +399,10 @@ module QuestDB
       true
     end
 
+    def ensure_durable_ack!(ack_level)
+      Config.ensure_durable_ack!(@durable_ack_requested, ack_level, ACK_LEVELS[:durable])
+    end
+
     def normalize_ack(value)
       value = value.to_sym if value.respond_to?(:to_sym)
       ACK_LEVELS.fetch(value) { raise ArgumentError, "ack must be :ok or :durable" }

data/lib/questdb/version.rb

@@ -21,7 +21,7 @@
 #
 module QuestDB
   module Ingress
-    VERSION = "0.1.0"
-    C_CLIENT_VERSION = "7.1.0"
+    VERSION = "0.1.1"
+    C_CLIENT_VERSION = "7.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: questdb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: x86_64-linux-gnu
 authors:
 - QuestDB
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal