questdb 0.1.0-aarch64-linux-gnu

data/lib/questdb/version.rb

@@ -0,0 +1,27 @@
+#      ___                  _   ____  ____
+#     / _ \ _   _  ___  ___| |_|  _ \| __ )
+#    | | | | | | |/ _ \/ __| __| | | |  _ \
+#    | |_| | |_| |  __/\__ \ |_| |_| | |_) |
+#     \__\_\\__,_|\___||___/\__|____/|____/
+#
+#   Copyright (c) 2014-2019 Appsicle
+#   Copyright (c) 2019-2026 QuestDB
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+module QuestDB
+  module Ingress
+    VERSION = "0.1.0"
+    C_CLIENT_VERSION = "7.1.0"
+  end
+end

data/lib/questdb.rb

@@ -0,0 +1,22 @@
+#      ___                  _   ____  ____
+#     / _ \ _   _  ___  ___| |_|  _ \| __ )
+#    | | | | | | |/ _ \/ __| __| | | |  _ \
+#    | |_| | |_| |  __/\__ \ |_| |_| | |_) |
+#     \__\_\\__,_|\___||___/\__|____/|____/
+#
+#   Copyright (c) 2014-2019 Appsicle
+#   Copyright (c) 2019-2026 QuestDB
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+require_relative "questdb/ingress"

data/questdb.gemspec

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+#      ___                  _   ____  ____
+#     / _ \ _   _  ___  ___| |_|  _ \| __ )
+#    | | | | | | |/ _ \/ __| __| | | |  _ \
+#    | |_| | |_| |  __/\__ \ |_| |_| | |_) |
+#     \__\_\\__,_|\___||___/\__|____/|____/
+#
+#   Copyright (c) 2014-2019 Appsicle
+#   Copyright (c) 2019-2026 QuestDB
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+require_relative "lib/questdb/version"
+Gem::Specification.new do |s|
+  s.name = "questdb"
+  s.version = QuestDB::Ingress::VERSION
+  s.summary = "Native QuestDB QWP client for Ruby"
+  s.description = "MRI Ruby bindings for pooled and standalone QuestDB Wire Protocol ingestion, queries, direct columnar and optional Arrow C Stream writes, and safe pool-wide callbacks, backed by the official C client."
+  s.authors = ["QuestDB"]
+  s.email = ["hello@questdb.io"]
+  s.homepage = "https://questdb.io/"
+  s.license = "Apache-2.0"
+  s.metadata = {
+    "allowed_push_host" => "https://rubygems.org",
+    "bug_tracker_uri" => "https://github.com/questdb/ruby-questdb-client/issues",
+    "changelog_uri" => "https://github.com/questdb/ruby-questdb-client/blob/main/CHANGELOG.md",
+    "documentation_uri" => "https://github.com/questdb/ruby-questdb-client#readme",
+    "homepage_uri" => "https://questdb.io/",
+    "rubygems_mfa_required" => "true",
+    "source_code_uri" => "https://github.com/questdb/ruby-questdb-client"
+  }
+  s.required_ruby_version = Gem::Requirement.new(">= 3.1", "< 3.5")
+  native_gem = ENV["QDB_NATIVE_GEM"] == "1"
+  if native_gem
+    platform = ENV.fetch("QDB_GEM_PLATFORM")
+    s.platform = Gem::Platform.new(platform)
+    s.required_rubygems_version = Gem::Requirement.new(">= 3.3.22") if platform.include?("-linux-")
+    package_globs = %w[lib/**/* docs/**/* examples/**/* sig/**/*]
+    generated = %r{(?:\A|/)\.git(?:/|$)}
+    s.extensions = []
+  else
+    package_globs = %w[lib/**/* ext/**/* vendor/**/* docs/**/* examples/**/* benchmark/**/* sig/**/* script/**/* test/**/* .cargo/**/*]
+    generated = %r{vendor/c-questdb-client/(?:questdb/|questdb-rs-ffi/target/)|(?:\A|/)\.git(?:/|$)|(?:\A|/)ext/.*\.o\z|\.(?:so|bundle)\z|(?:\A|/)ext/[^/]*/Makefile\z|(?:\A|/)ext/[^/]*/mkmf\.log\z|(?:\A|/)lib/questdb/native/}
+    s.extensions = ["ext/questdb_ingress/extconf.rb"]
+  end
+  s.files = Dir.glob(package_globs, File::FNM_DOTMATCH).select { |f| File.file?(f) && f !~ generated }
+  s.files = (s.files + %w[questdb.gemspec LICENSE.txt THIRD_PARTY_NOTICES.md README.md CHANGELOG.md SECURITY.md]).uniq.sort
+  s.files.concat(%w[Gemfile Rakefile CONTRIBUTING.md vendor/c-questdb-client.version]) unless native_gem
+  s.files.uniq!
+  s.files.sort!
+  s.require_paths = ["lib"]
+  s.add_dependency "bigdecimal", "~> 3.0"
+  s.add_development_dependency "minitest", "~> 5.20"
+  s.add_development_dependency "mutex_m", "~> 0.3"
+  s.add_development_dependency "rake", "~> 13.0"
+  s.add_development_dependency "rake-compiler", "~> 1.2"
+  s.add_development_dependency "rbs", "~> 3.0"
+end

data/sig/questdb-arrow.rbs

@@ -0,0 +1,46 @@
+#      ___                  _   ____  ____
+#     / _ \ _   _  ___  ___| |_|  _ \| __ )
+#    | | | | | | |/ _ \/ __| __| | | |  _ \
+#    | |_| | |_| |  __/\__ \ |_| |_| | |_) |
+#     \__\_\\__,_|\___||___/\__|____/|____/
+#
+#   Copyright (c) 2014-2019 Appsicle
+#   Copyright (c) 2019-2026 QuestDB
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+module QuestDB
+  module Arrow
+    def self.normalize_at: (untyped value) -> [Integer, untyped]
+    def self.normalize_overrides: (Symbol | Array[String | Symbol] | nil symbols, Hash[String | Symbol, untyped] overrides) -> Array[[String | Symbol, Integer, Integer]]
+  end
+
+  class Client
+    def ingest_arrow: (String | Symbol table, untyped source, at: untyped, ?symbols: Symbol | Array[String | Symbol], ?schema_overrides: Hash[String | Symbol, untyped], ?ack: Symbol, ?checkpoint_batches: Integer) -> Client
+  end
+
+  class PooledSender
+    def ingest_arrow: (String | Symbol table, untyped source, at: untyped, ?symbols: Symbol | Array[String | Symbol], ?schema_overrides: Hash[String | Symbol, untyped], ?ack: Symbol, ?checkpoint_batches: Integer) -> PooledSender
+  end
+
+  class Sender
+    def ingest_arrow: (String | Symbol table, untyped source, at: untyped, ?symbols: Symbol | Array[String | Symbol], ?schema_overrides: Hash[String | Symbol, untyped], ?ack: Symbol, ?checkpoint_batches: Integer) -> Sender
+  end
+
+  class QueryResult
+    def arrow_c_stream: () -> untyped
+    def to_nanoarrow: () -> untyped
+    def to_polars: () -> untyped
+    def to_red_arrow_table: () -> untyped
+  end
+end

data/sig/questdb.rbs

@@ -0,0 +1,337 @@
+#      ___                  _   ____  ____
+#     / _ \ _   _  ___  ___| |_|  _ \| __ )
+#    | | | | | | |/ _ \/ __| __| | | |  _ \
+#    | |_| | |_| |  __/\__ \ |_| |_| | |_) |
+#     \__\_\\__,_|\___||___/\__|____/|____/
+#
+#   Copyright (c) 2014-2019 Appsicle
+#   Copyright (c) 2019-2026 QuestDB
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+module QuestDB
+  VERSION: String
+  C_CLIENT_VERSION: String
+  SERVER_TIMESTAMP: untyped
+
+  class Error < StandardError
+    attr_reader code: Symbol
+    attr_reader sender_error: SenderError?
+    def initialize: (String message, ?code: Symbol, ?in_doubt: bool, ?sender_error: SenderError | Array[untyped]?) -> void
+    def in_doubt?: () -> bool
+  end
+  class ServerRejectionError < Error
+  end
+  QuestDBError: singleton(Error)
+  QuestDBServerRejectionError: singleton(ServerRejectionError)
+
+  class Timestamp
+    attr_reader value: Integer
+    def initialize: (Integer value) -> void
+    def ==: (untyped other) -> bool
+  end
+  class TimestampNanos < Timestamp
+    def self.now: () -> TimestampNanos
+    def self.from_time: (Time time) -> TimestampNanos
+  end
+  class TimestampMicros < Timestamp
+    def self.now: () -> TimestampMicros
+    def self.from_time: (Time time) -> TimestampMicros
+  end
+
+  class Float64Array
+    attr_reader values: Array[Float]
+    attr_reader shape: Array[Integer]
+    def initialize: (Array[Numeric] values, shape: Array[Integer]) -> void
+    def self.from_nested: (Array[untyped] value) -> Float64Array
+    def self.from_native: (Array[Numeric] values, Array[Integer] shape) -> Float64Array
+  end
+
+  class DateMillis
+    attr_reader value: Integer
+    def initialize: (Integer value) -> void
+    def to_time: () -> Time
+  end
+  class Char
+    attr_reader value: Integer
+    def initialize: (Integer | String value) -> void
+    def to_s: () -> String
+  end
+  class UUID
+    attr_reader bytes: String
+    def initialize: (String | UUID value) -> void
+    def self.from_bytes: (String bytes) -> UUID
+    def to_s: () -> String
+  end
+  class Binary
+    attr_reader bytes: String
+    def initialize: (String bytes) -> void
+  end
+  class IPv4
+    attr_reader value: Integer
+    def initialize: (untyped value) -> void
+    def to_s: () -> String
+  end
+  class Geohash
+    attr_reader value: Integer
+    attr_reader precision_bits: Integer
+    def initialize: (Integer value, precision_bits: Integer) -> void
+  end
+  class Long256
+    attr_reader value: Integer
+    def initialize: (Integer value) -> void
+    def bytes: () -> String
+  end
+  class DecimalValue
+    attr_reader mantissa: Integer
+    attr_reader scale: Integer
+    def initialize: (Integer mantissa, scale: Integer) -> void
+    def to_d: () -> BigDecimal
+    def to_s: () -> String
+  end
+  class TypedNull
+    attr_reader kind: Symbol
+    attr_reader scale: Integer?
+    attr_reader precision_bits: Integer?
+    def initialize: (Symbol kind, ?scale: Integer?, ?precision_bits: Integer?) -> void
+  end
+  class OpaqueValue
+    attr_reader kind: untyped
+    attr_reader bytes: String?
+  end
+
+  class ColumnVector
+    attr_reader kind: Symbol
+    attr_reader values: Array[untyped]
+    attr_reader scale: Integer?
+    attr_reader precision_bits: Integer?
+    attr_reader shape: Array[Integer]?
+    def initialize: (Symbol kind, Array[untyped] values, ?scale: Integer?, ?precision_bits: Integer?, ?shape: Array[Integer]?) -> void
+    def self.byte: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.short: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.int: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.long: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.float: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.double: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.boolean: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.varchar: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.binary: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.uuid: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.long256: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.ipv4: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.timestamp: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.timestamp_nanos: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.date: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.char: (Array[untyped] values, **untyped metadata) -> ColumnVector
+    def self.geohash: (Array[untyped] values, precision_bits: Integer) -> ColumnVector
+    def self.decimal64: (Array[untyped] values, scale: Integer) -> ColumnVector
+    def self.decimal128: (Array[untyped] values, scale: Integer) -> ColumnVector
+    def self.decimal256: (Array[untyped] values, scale: Integer) -> ColumnVector
+    def self.double_array: (Array[untyped] values, shape: Array[Integer]) -> ColumnVector
+  end
+
+  class ConnectionEvent
+    attr_reader kind: Symbol
+    attr_reader host: String?
+    attr_reader port: String?
+    attr_reader previous_host: String?
+    attr_reader previous_port: String?
+    attr_reader attempt_number: Integer?
+    attr_reader cause_code: Symbol?
+    attr_reader cause_message: String?
+    attr_reader timestamp_millis: Integer
+  end
+
+  class SenderError
+    attr_reader category: Symbol
+    attr_reader applied_policy: Symbol
+    attr_reader status: Integer?
+    attr_reader message: String
+    attr_reader message_sequence: Integer?
+    attr_reader from_fsn: Integer
+    attr_reader to_fsn: Integer
+    def terminal?: () -> bool
+    def retriable?: () -> bool
+  end
+
+  class Client
+    def self.from_conf: (String conf, ?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) -> Client
+    def self.from_env: (?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) -> Client
+    def sender: () -> PooledSender
+              | [A] () { (PooledSender) -> A } -> A
+    def reader: () -> PooledReader
+              | [A] () { (PooledReader) -> A } -> A
+    def query: (String sql, ?binds: Array[untyped]?, ?reset_symbol_dict: bool) -> QueryResult
+             | [A] (String sql, ?binds: Array[untyped]?, ?reset_symbol_dict: bool) { (QueryResult) -> A } -> A
+    def ingest_columns: (String | Symbol table, columns: Hash[String | Symbol, Array[untyped] | ColumnVector], ?symbols: Hash[String | Symbol, Array[String?] | ColumnVector], at: untyped, ?max_rows_per_batch: Integer, ?ack: Symbol) -> Client
+    alias write_columns ingest_columns
+    def execute: (String sql, ?binds: Array[untyped]?) -> nil
+    def server_info: () -> ServerInfo
+    def reap_idle: () -> Integer
+    def connection_events_delivered: () -> Integer
+    def connection_events_dropped: () -> Integer
+    def error_events_delivered: () -> Integer
+    def error_events_dropped: () -> Integer
+    def poll_connection_event: () -> ConnectionEvent?
+    def poll_error: () -> SenderError?
+    def active_leases: () -> Integer
+    def active_senders: () -> Integer
+    def closed?: () -> bool
+    def close: () -> Client
+    def open: [A] () { (Client) -> A } -> A
+  end
+
+  class Column
+    attr_reader name: String
+    attr_reader kind: Symbol
+    attr_reader metadata: Hash[Symbol, untyped]
+  end
+  class Row
+    attr_reader names: Array[String]
+    attr_reader values: Array[untyped]
+    def []: (Integer | String | Symbol key) -> untyped
+    def fetch: (Integer | String | Symbol key, *untyped defaults) -> untyped
+    def to_a: () -> Array[untyped]
+    def to_h: () -> Hash[String, untyped]
+  end
+  class ResultBatch
+    attr_reader columns: Array[Column]
+    attr_reader rows: Array[Row]
+    def row_count: () -> Integer
+    def column_count: () -> Integer
+    def empty?: () -> bool
+  end
+  class ServerInfo
+    attr_reader role: Symbol
+    attr_reader raw_role: Integer
+    attr_reader epoch: Integer
+    attr_reader capabilities: Integer
+    attr_reader server_wall_ns: Integer
+    attr_reader cluster_id: String
+    attr_reader node_id: String
+    attr_reader zone_id: String?
+  end
+  class QueryResult
+    include Enumerable[Row]
+    attr_reader columns: Array[Column]?
+    def each: () { (Row) -> void } -> QueryResult
+    def each_batch: () { (ResultBatch) -> void } -> QueryResult
+    def each_values: () { (Array[untyped]) -> void } -> QueryResult
+    def to_a: () -> Array[Row]
+    def cancel: () -> QueryResult
+    def close: () -> QueryResult
+    def closed?: () -> bool
+    def consumed?: () -> bool
+    def open: [A] () { (QueryResult) -> A } -> A
+  end
+  class PooledReader
+    def query: (String sql, ?binds: Array[untyped]?, ?reset_symbol_dict: bool) -> QueryResult
+             | [A] (String sql, ?binds: Array[untyped]?, ?reset_symbol_dict: bool) { (QueryResult) -> A } -> A
+    def execute: (String sql, ?binds: Array[untyped]?) -> nil
+    def server_info: () -> ServerInfo
+    def close: () -> PooledReader
+    def closed?: () -> bool
+    def open: [A] () { (PooledReader) -> A } -> A
+  end
+
+  class Sender
+    attr_reader protocol: Symbol
+    attr_reader init_buf_size: Integer
+    attr_reader auto_flush_rows: Integer?
+    attr_reader auto_flush_bytes: Integer?
+    attr_reader auto_flush_interval: Integer?
+    def initialize: (protocol: Symbol, host: String, ?port: Integer, ?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) -> void
+    def self.from_conf: (String conf, ?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) -> Sender
+    def self.from_env: (?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) -> Sender
+    def establish: () -> Sender
+    def established?: () -> bool
+    def auto_flush?: () -> bool
+    def auto_flush: () -> bool
+    def new_buffer: () -> Ingress::Buffer
+    def row: (String | Symbol table, ?symbols: Hash[String | Symbol, String?], ?columns: Hash[String | Symbol, untyped], at: untyped) -> Sender
+    def ingest_columns: (String | Symbol table, columns: Hash[String | Symbol, Array[untyped] | ColumnVector], ?symbols: Hash[String | Symbol, Array[String?] | ColumnVector], at: untyped, ?max_rows_per_batch: Integer, ?ack: Symbol) -> Sender
+    alias write_columns ingest_columns
+    def row_count: () -> Integer
+    def length: () -> Integer
+    def empty?: () -> bool
+    def closed?: () -> bool
+    def flush: (?buffer: Ingress::Buffer?, ?clear: bool, ?wait: bool, ?ack: Symbol) -> Sender
+    def wait: (?timeout_millis: Integer, ?ack: Symbol) -> Sender
+    def flush_and_get_fsn: () -> Integer?
+    def flush_and_keep_and_get_fsn: (?Ingress::Buffer? buffer) -> Integer?
+    def published_fsn: () -> Integer?
+    def acked_fsn: () -> Integer?
+    def await_acked_fsn: (Integer fsn, ?timeout_millis: Integer) -> bool
+    def drive_once: () -> bool
+    def close_drain: () -> Sender
+    def poll_error: () -> SenderError?
+    def poll_connection_event: () -> ConnectionEvent?
+    def poll_callback_error: () -> SenderError?
+    def error_events_delivered: () -> Integer
+    def error_events_dropped: () -> Integer
+    def connection_events_delivered: () -> Integer
+    def connection_events_dropped: () -> Integer
+    def close: (?flush: bool, ?wait: bool, ?drain: bool?) -> Sender
+    def open: [A] () { (Sender) -> A } -> A
+  end
+
+  class PooledSender
+    attr_reader auto_flush_rows: Integer?
+    attr_reader auto_flush_bytes: Integer?
+    attr_reader auto_flush_interval: Integer?
+    def row: (String | Symbol table, ?symbols: Hash[String | Symbol, String?], ?columns: Hash[String | Symbol, untyped], at: untyped) -> PooledSender
+    def row_count: () -> Integer
+    def length: () -> Integer
+    def empty?: () -> bool
+    def closed?: () -> bool
+    def flush: (?wait: bool, ?ack: Symbol) -> PooledSender
+    def wait: (?timeout_millis: Integer, ?ack: Symbol) -> PooledSender
+    def flush_and_get_fsn: () -> Integer?
+    def flush_and_keep_and_get_fsn: () -> Integer?
+    def published_fsn: () -> Integer?
+    def acked_fsn: () -> Integer?
+    def await_acked_fsn: (Integer fsn, ?timeout_millis: Integer) -> bool
+    def ingest_columns: (String | Symbol table, columns: Hash[String | Symbol, Array[untyped] | ColumnVector], ?symbols: Hash[String | Symbol, Array[String?] | ColumnVector], at: untyped, ?max_rows_per_batch: Integer, ?ack: Symbol) -> PooledSender
+    alias write_columns ingest_columns
+    def poll_error: () -> SenderError?
+    def error_events_dropped: () -> Integer
+    def close: (?flush: bool, ?wait: bool) -> PooledSender
+    def open: [A] () { (PooledSender) -> A } -> A
+  end
+
+  def self.connect: (?String conf, ?host: String, ?port: Integer, ?tls: bool, ?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) -> Client
+                  | [A] (?String conf, ?host: String, ?port: Integer, ?tls: bool, ?connection_listener: (^(ConnectionEvent) -> void)?, ?error_handler: (^(SenderError) -> void)?, ?connection_event_inbox_capacity: Integer, ?error_event_inbox_capacity: Integer, **untyped settings) { (Client) -> A } -> A
+
+  module Ingress
+    VERSION: String
+    C_CLIENT_VERSION: String
+    SERVER_TIMESTAMP: untyped
+    IngressError: singleton(QuestDB::Error)
+    ServerRejectionError: singleton(QuestDB::ServerRejectionError)
+    Timestamp: singleton(QuestDB::Timestamp)
+    TimestampNanos: singleton(QuestDB::TimestampNanos)
+    TimestampMicros: singleton(QuestDB::TimestampMicros)
+    Float64Array: singleton(QuestDB::Float64Array)
+
+    class Buffer
+      def row: (String | Symbol table, ?symbols: Hash[String | Symbol, String?], ?columns: Hash[String | Symbol, untyped], at: untyped) -> Buffer
+      def row_count: () -> Integer
+      def length: () -> Integer
+      def empty?: () -> bool
+      def bytesize: () -> Integer
+      def capacity: () -> Integer
+      def reserve: (Integer additional) -> Buffer
+      def clear: () -> Buffer
+    end
+  end
+end