turbopuffer 1.5.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2f5759ef6a54d8d20fd914a7afb761b2f63e9383fe76094336a59d2dd77c887
-  data.tar.gz: 6186eaa83038a13743abdc63737933c49666249bf4435067551ac1271c47202e
+  metadata.gz: e86efb79e86d8d7b74b0139e810bef55805bae162b9fab4eed29be9425e104e9
+  data.tar.gz: d4f37a4e3fb10f033a476546319f5dc2238f741d1485eb5917758e50dba8d3cd
 SHA512:
-  metadata.gz: 6c1dc39006702ca0bdba4684355c7c4436522fd796c33031b553523808b2ae6486bbc5865a1e55d5986ccafa837c6ac914319f9171914e1391ff9c9e527f116d
-  data.tar.gz: 5b77e8508f24ffbac98423426cc270e812f6ef434d50ceab6397cb8b905e4e4e4a8a2f52f62b84c4051afc2955899f74c39cec35ef6039386eae837567ed5908
+  metadata.gz: c86bfa585e8c3ca4fe60de6df7b69bf39152ca8f23b6cde8a6bfa8e4fa25c5c6581e504d4dc9de8a9091ed0e045bfb00478006e4016266976f241af985d33421
+  data.tar.gz: a8bd49b7edd37e4eb795bd0fb1cd75dfdfa090f4e63fe8b06eede5d3ea2e69bf3060b2a89ba17093f474c9ae6d9cde5684285af4fbc0cc5397a3957bbc5a2fb6

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 1.7.0 (2025-11-17)
+
+Full Changelog: [v1.6.0...v1.7.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.6.0...v1.7.0)
+
+### Features
+
+* Allow for a CMEK key to be specified in copy_from_namespace ([5c29fe0](https://github.com/turbopuffer/turbopuffer-ruby/commit/5c29fe01f4fb0e9795d92e7c0d27fbc3fc9c2c52))
+* spec: add support for cross-org CFN to SDKs ([eb1028c](https://github.com/turbopuffer/turbopuffer-ruby/commit/eb1028cf9c62e50a1d62866eb399a51fd12424e8))
+
+## 1.6.0 (2025-11-06)
+
+Full Changelog: [v1.5.0...v1.6.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.5.0...v1.6.0)
+
+### Features
+
+* Add vector attribute schema to metadata endpoint ([a509e47](https://github.com/turbopuffer/turbopuffer-ruby/commit/a509e479bc8fdeb6a72b39703636d1ccc331274e))
+* handle thread interrupts in the core HTTP client ([ad531ac](https://github.com/turbopuffer/turbopuffer-ruby/commit/ad531ac4776d6445a23033601d7e46900f8824bc))
+* Make `type` required on `AttributeSchemaConfig` ([c9300f6](https://github.com/turbopuffer/turbopuffer-ruby/commit/c9300f621999c6937d16c363ba7bdb423605a825))
+* openapi: Fix stainless warnings ([1b7685f](https://github.com/turbopuffer/turbopuffer-ruby/commit/1b7685f30fd448eff4d17b809714ee01aa864ffd))
+* openapi: name variants of `NamespaceMetadata.index` ([3b7cd24](https://github.com/turbopuffer/turbopuffer-ruby/commit/3b7cd24aa4f0fbb0c7f805d28f3c0e20726697de))
+
+
+### Bug Fixes
+
+* better thread safety via early initializing SSL store during HTTP client creation ([588faf7](https://github.com/turbopuffer/turbopuffer-ruby/commit/588faf74de4e21652afadd3eb557062818639cd6))
+
+
+### Chores
+
+* bump dependency version and update sorbet types ([b8c6c9a](https://github.com/turbopuffer/turbopuffer-ruby/commit/b8c6c9a56cf98142d6736e21b25fa3a541fafd47))
+* **client:** send user-agent header ([dda4633](https://github.com/turbopuffer/turbopuffer-ruby/commit/dda4633d4fe3cfb16b90d5d4b32aa887ee810d52))
+
 ## 1.5.0 (2025-10-21)
 
 Full Changelog: [v1.4.0...v1.5.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.4.0...v1.5.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "turbopuffer", "~> 1.5.0"
+gem "turbopuffer", "~> 1.7.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/internal/transport/base_client.rb

@@ -201,7 +201,8 @@ module Turbopuffer
             self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
-              "content-type" => "application/json"
+              "content-type" => "application/json",
+              "user-agent" => user_agent
             },
             headers
           )
@@ -219,6 +220,11 @@ module Turbopuffer
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{Turbopuffer::VERSION}"
+
         # @api private
         #
         # @return [String]

data/lib/turbopuffer/internal/transport/pooled_net_requester.rb

@@ -16,10 +16,11 @@ module Turbopuffer
         class << self
           # @api private
           #
+          # @param cert_store [OpenSSL::X509::Store]
           # @param url [URI::Generic]
           #
           # @return [Net::HTTP]
-          def connect(url)
+          def connect(cert_store:, url:)
             port =
               case [url.port, url.scheme]
               in [Integer, _]
@@ -33,6 +34,8 @@ module Turbopuffer
             Net::HTTP.new(url.host, port).tap do
               _1.use_ssl = %w[https wss].include?(url.scheme)
               _1.max_retries = 0
+
+              (_1.cert_store = cert_store) if _1.use_ssl?
             end
           end
 
@@ -102,7 +105,7 @@ module Turbopuffer
           pool =
             @mutex.synchronize do
               @pools[origin] ||= ConnectionPool.new(size: @size) do
-                self.class.connect(url)
+                self.class.connect(cert_store: @cert_store, url: url)
               end
             end
 
@@ -128,40 +131,48 @@ module Turbopuffer
           url, deadline = request.fetch_values(:url, :deadline)
 
           req = nil
-          eof = false
           finished = false
-          closing = nil
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
             next if finished
 
             with_pool(url, deadline: deadline) do |conn|
-              req, closing = self.class.build_request(request) do
-                self.class.calibrate_socket_timeout(conn, deadline)
-              end
-
-              self.class.calibrate_socket_timeout(conn, deadline)
-              unless conn.started?
-                conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
-                conn.start
-              end
+              eof = false
+              closing = nil
+              ::Thread.handle_interrupt(Object => :never) do
+                ::Thread.handle_interrupt(Object => :immediate) do
+                  req, closing = self.class.build_request(request) do
+                    self.class.calibrate_socket_timeout(conn, deadline)
+                  end
 
-              self.class.calibrate_socket_timeout(conn, deadline)
-              conn.request(req) do |rsp|
-                y << [req, rsp]
-                break if finished
-
-                rsp.read_body do |bytes|
-                  y << bytes.force_encoding(Encoding::BINARY)
-                  break if finished
+                  self.class.calibrate_socket_timeout(conn, deadline)
+                  unless conn.started?
+                    conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
+                    conn.start
+                  end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
+                  conn.request(req) do |rsp|
+                    y << [req, rsp]
+                    break if finished
+
+                    rsp.read_body do |bytes|
+                      y << bytes.force_encoding(Encoding::BINARY)
+                      break if finished
+
+                      self.class.calibrate_socket_timeout(conn, deadline)
+                    end
+                    eof = true
+                  end
+                end
+              ensure
+                begin
+                  conn.finish if !eof && conn&.started?
+                ensure
+                  closing&.call
                 end
-                eof = true
               end
-            ensure
-              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise Turbopuffer::Errors::APITimeoutError.new(url: url, request: req)
@@ -174,8 +185,6 @@ module Turbopuffer
           body = Turbopuffer::Internal::Util.fused_enum(enum, external: true) do
             finished = true
             loop { enum.next }
-          ensure
-            closing&.call
           end
           [Integer(response.code), response, body]
         end
@@ -186,6 +195,7 @@ module Turbopuffer
         def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
           @mutex = Mutex.new
           @size = size
+          @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @pools = {}
         end
 

data/lib/turbopuffer/internal/type/union.rb

@@ -11,7 +11,7 @@ module Turbopuffer
       #   when Turbopuffer::AttributeType
       #     # ...
       #   when Turbopuffer::AttributeSchemaConfig
-      #     puts(attribute_schema.ann)
+      #     puts(attribute_schema.type)
       #   else
       #     puts(attribute_schema)
       #   end

data/lib/turbopuffer/models/attribute_schema_config.rb

@@ -3,11 +3,20 @@
 module Turbopuffer
   module Models
     class AttributeSchemaConfig < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute type
+      #   The data type of the attribute. Valid values: string, int, uint, float, uuid,
+      #   datetime, bool, []string, []int, []uint, []float, []uuid, []datetime, []bool,
+      #   [DIMS]f16, [DIMS]f32.
+      #
+      #   @return [String]
+      required :type, String
+
       # @!attribute ann
-      #   Whether to create an approximate nearest neighbor index for the attribute.
+      #   Whether to create an approximate nearest neighbor index for the attribute. Can
+      #   be a boolean or a detailed configuration object.
       #
-      #   @return [Boolean, nil]
-      optional :ann, Turbopuffer::Internal::Type::Boolean
+      #   @return [Boolean, Turbopuffer::Models::AttributeSchemaConfig::Ann::AnnConfig, nil]
+      optional :ann, union: -> { Turbopuffer::AttributeSchemaConfig::Ann }
 
       # @!attribute filterable
       #   Whether or not the attributes can be used in filters.
@@ -29,29 +38,50 @@ module Turbopuffer
       #   @return [Boolean, nil]
       optional :regex, Turbopuffer::Internal::Type::Boolean
 
-      # @!attribute type
-      #   The data type of the attribute. Valid values: string, int, uint, float, uuid,
-      #   datetime, bool, []string, []int, []uint, []float, []uuid, []datetime, []bool,
-      #   [DIMS]f16, [DIMS]f32.
-      #
-      #   @return [String, nil]
-      optional :type, String
-
-      # @!method initialize(ann: nil, filterable: nil, full_text_search: nil, regex: nil, type: nil)
+      # @!method initialize(type:, ann: nil, filterable: nil, full_text_search: nil, regex: nil)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::AttributeSchemaConfig} for more details.
       #
       #   Detailed configuration for an attribute attached to a document.
       #
-      #   @param ann [Boolean] Whether to create an approximate nearest neighbor index for the attribute.
+      #   @param type [String] The data type of the attribute. Valid values: string, int, uint, float, uuid, da
+      #
+      #   @param ann [Boolean, Turbopuffer::Models::AttributeSchemaConfig::Ann::AnnConfig] Whether to create an approximate nearest neighbor index for the attribute. Can b
       #
       #   @param filterable [Boolean] Whether or not the attributes can be used in filters.
       #
       #   @param full_text_search [Boolean, Turbopuffer::Models::FullTextSearchConfig] Whether this attribute can be used as part of a BM25 full-text search. Requires
       #
       #   @param regex [Boolean] Whether to enable Regex filters on this attribute.
+
+      # Whether to create an approximate nearest neighbor index for the attribute. Can
+      # be a boolean or a detailed configuration object.
       #
-      #   @param type [String] The data type of the attribute. Valid values: string, int, uint, float, uuid, da
+      # @see Turbopuffer::Models::AttributeSchemaConfig#ann
+      module Ann
+        extend Turbopuffer::Internal::Type::Union
+
+        variant Turbopuffer::Internal::Type::Boolean
+
+        # Configuration options for ANN (Approximate Nearest Neighbor) indexing.
+        variant -> { Turbopuffer::AttributeSchemaConfig::Ann::AnnConfig }
+
+        class AnnConfig < Turbopuffer::Internal::Type::BaseModel
+          # @!attribute distance_metric
+          #   A function used to calculate vector similarity.
+          #
+          #   @return [Symbol, Turbopuffer::Models::DistanceMetric, nil]
+          optional :distance_metric, enum: -> { Turbopuffer::DistanceMetric }
+
+          # @!method initialize(distance_metric: nil)
+          #   Configuration options for ANN (Approximate Nearest Neighbor) indexing.
+          #
+          #   @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] A function used to calculate vector similarity.
+        end
+
+        # @!method self.variants
+        #   @return [Array(Boolean, Turbopuffer::Models::AttributeSchemaConfig::Ann::AnnConfig)]
+      end
     end
   end
 end

data/lib/turbopuffer/models/namespace_metadata.rb

@@ -22,6 +22,18 @@ module Turbopuffer
       #   @return [Time]
       required :created_at, Time
 
+      # @!attribute encryption
+      #   Indicates that the namespace is encrypted with a customer-managed encryption key
+      #   (CMEK).
+      #
+      #   @return [Turbopuffer::Models::NamespaceMetadata::Encryption::Sse, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek]
+      required :encryption, union: -> { Turbopuffer::NamespaceMetadata::Encryption }
+
+      # @!attribute index
+      #
+      #   @return [Turbopuffer::Models::NamespaceMetadata::Index::IndexUpToDate, Turbopuffer::Models::NamespaceMetadata::Index::IndexUpdating]
+      required :index, union: -> { Turbopuffer::NamespaceMetadata::Index }
+
       # @!attribute schema
       #   The schema of the namespace.
       #
@@ -34,19 +46,7 @@ module Turbopuffer
       #   @return [Time]
       required :updated_at, Time
 
-      # @!attribute encryption
-      #   Indicates that the namespace is encrypted with a customer-managed encryption key
-      #   (CMEK).
-      #
-      #   @return [Boolean, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek, nil]
-      optional :encryption, union: -> { Turbopuffer::NamespaceMetadata::Encryption }
-
-      # @!attribute index
-      #
-      #   @return [Turbopuffer::Models::NamespaceMetadata::Index::Status, Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1, nil]
-      optional :index, union: -> { Turbopuffer::NamespaceMetadata::Index }
-
-      # @!method initialize(approx_logical_bytes:, approx_row_count:, created_at:, schema:, updated_at:, encryption: nil, index: nil)
+      # @!method initialize(approx_logical_bytes:, approx_row_count:, created_at:, encryption:, index:, schema:, updated_at:)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceMetadata} for more details.
       #
@@ -58,13 +58,13 @@ module Turbopuffer
       #
       #   @param created_at [Time] The timestamp when the namespace was created.
       #
-      #   @param schema [Hash{Symbol=>Turbopuffer::Models::AttributeSchemaConfig}] The schema of the namespace.
+      #   @param encryption [Turbopuffer::Models::NamespaceMetadata::Encryption::Sse, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek] Indicates that the namespace is encrypted with a customer-managed encryption key
       #
-      #   @param updated_at [Time] The timestamp when the namespace was last modified by a write operation.
+      #   @param index [Turbopuffer::Models::NamespaceMetadata::Index::IndexUpToDate, Turbopuffer::Models::NamespaceMetadata::Index::IndexUpdating]
       #
-      #   @param encryption [Boolean, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek] Indicates that the namespace is encrypted with a customer-managed encryption key
+      #   @param schema [Hash{Symbol=>Turbopuffer::Models::AttributeSchemaConfig}] The schema of the namespace.
       #
-      #   @param index [Turbopuffer::Models::NamespaceMetadata::Index::Status, Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1]
+      #   @param updated_at [Time] The timestamp when the namespace was last modified by a write operation.
 
       # Indicates that the namespace is encrypted with a customer-managed encryption key
       # (CMEK).
@@ -73,18 +73,29 @@ module Turbopuffer
       module Encryption
         extend Turbopuffer::Internal::Type::Union
 
-        variant Turbopuffer::Internal::Type::Boolean
+        variant -> { Turbopuffer::NamespaceMetadata::Encryption::Sse }
 
         # Indicates that the namespace is encrypted with a customer-managed encryption key (CMEK).
         variant -> { Turbopuffer::NamespaceMetadata::Encryption::Cmek }
 
+        class Sse < Turbopuffer::Internal::Type::BaseModel
+          # @!attribute sse
+          #   Always true. Indicates that the namespace is encrypted with SSE.
+          #
+          #   @return [Boolean]
+          required :sse, Turbopuffer::Internal::Type::Boolean
+
+          # @!method initialize(sse:)
+          #   @param sse [Boolean] Always true. Indicates that the namespace is encrypted with SSE.
+        end
+
         class Cmek < Turbopuffer::Internal::Type::BaseModel
           # @!attribute cmek
           #
-          #   @return [Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek::Cmek, nil]
-          optional :cmek, -> { Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek }
+          #   @return [Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek::Cmek]
+          required :cmek, -> { Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek }
 
-          # @!method initialize(cmek: nil)
+          # @!method initialize(cmek:)
           #   Indicates that the namespace is encrypted with a customer-managed encryption key
           #   (CMEK).
           #
@@ -104,18 +115,18 @@ module Turbopuffer
         end
 
         # @!method self.variants
-        #   @return [Array(Boolean, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek)]
+        #   @return [Array(Turbopuffer::Models::NamespaceMetadata::Encryption::Sse, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek)]
       end
 
       # @see Turbopuffer::Models::NamespaceMetadata#index
       module Index
         extend Turbopuffer::Internal::Type::Union
 
-        variant -> { Turbopuffer::NamespaceMetadata::Index::Status }
+        variant -> { Turbopuffer::NamespaceMetadata::Index::IndexUpToDate }
 
-        variant -> { Turbopuffer::NamespaceMetadata::Index::UnionMember1 }
+        variant -> { Turbopuffer::NamespaceMetadata::Index::IndexUpdating }
 
-        class Status < Turbopuffer::Internal::Type::BaseModel
+        class IndexUpToDate < Turbopuffer::Internal::Type::BaseModel
           # @!attribute status
           #
           #   @return [Symbol, :"up-to-date"]
@@ -125,7 +136,7 @@ module Turbopuffer
           #   @param status [Symbol, :"up-to-date"]
         end
 
-        class UnionMember1 < Turbopuffer::Internal::Type::BaseModel
+        class IndexUpdating < Turbopuffer::Internal::Type::BaseModel
           # @!attribute status
           #
           #   @return [Symbol, :updating]
@@ -140,7 +151,7 @@ module Turbopuffer
 
           # @!method initialize(unindexed_bytes:, status: :updating)
           #   Some parameter documentations has been truncated, see
-          #   {Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1} for more details.
+          #   {Turbopuffer::Models::NamespaceMetadata::Index::IndexUpdating} for more details.
           #
           #   @param unindexed_bytes [Integer] The number of bytes in the namespace that are in the write-ahead log but have no
           #
@@ -148,7 +159,7 @@ module Turbopuffer
         end
 
         # @!method self.variants
-        #   @return [Array(Turbopuffer::Models::NamespaceMetadata::Index::Status, Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1)]
+        #   @return [Array(Turbopuffer::Models::NamespaceMetadata::Index::IndexUpToDate, Turbopuffer::Models::NamespaceMetadata::Index::IndexUpdating)]
       end
     end
   end

data/lib/turbopuffer/models/namespace_write_params.rb

@@ -15,8 +15,8 @@ module Turbopuffer
       # @!attribute copy_from_namespace
       #   The namespace to copy documents from.
       #
-      #   @return [String, nil]
-      optional :copy_from_namespace, String
+      #   @return [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig, nil]
+      optional :copy_from_namespace, union: -> { Turbopuffer::NamespaceWriteParams::CopyFromNamespace }
 
       # @!attribute delete_by_filter
       #   The filter specifying which documents to delete.
@@ -110,7 +110,7 @@ module Turbopuffer
       #
       #   @param namespace [String]
       #
-      #   @param copy_from_namespace [String] The namespace to copy documents from.
+      #   @param copy_from_namespace [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig] The namespace to copy documents from.
       #
       #   @param delete_by_filter [Object] The filter specifying which documents to delete.
       #
@@ -142,6 +142,38 @@ module Turbopuffer
       #
       #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
 
+      # The namespace to copy documents from.
+      module CopyFromNamespace
+        extend Turbopuffer::Internal::Type::Union
+
+        # The namespace to copy documents from.
+        variant String
+
+        variant -> { Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig }
+
+        class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+          # @!attribute source_api_key
+          #   An API key for the organization containing the source namespace
+          #
+          #   @return [String]
+          required :source_api_key, String
+
+          # @!attribute source_namespace
+          #   The namespace to copy documents from.
+          #
+          #   @return [String]
+          required :source_namespace, String
+
+          # @!method initialize(source_api_key:, source_namespace:)
+          #   @param source_api_key [String] An API key for the organization containing the source namespace
+          #
+          #   @param source_namespace [String] The namespace to copy documents from.
+        end
+
+        # @!method self.variants
+        #   @return [Array(String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig)]
+      end
+
       class Encryption < Turbopuffer::Internal::Type::BaseModel
         # @!attribute cmek
         #

data/lib/turbopuffer/resources/namespaces.rb

@@ -309,7 +309,7 @@ module Turbopuffer
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
-      # @param copy_from_namespace [String] Body param: The namespace to copy documents from.
+      # @param copy_from_namespace [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig] Body param: The namespace to copy documents from.
       #
       # @param delete_by_filter [Object] Body param: The filter specifying which documents to delete.
       #

data/lib/turbopuffer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Turbopuffer
-  VERSION = "1.5.0"
+  VERSION = "1.7.0"
 end

data/lib/turbopuffer.rb

@@ -9,6 +9,7 @@ require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"

data/manifest.yaml

@@ -6,6 +6,7 @@ dependencies:
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/turbopuffer/internal/transport/base_client.rbi

@@ -180,6 +180,11 @@ module Turbopuffer
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/turbopuffer/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module Turbopuffer
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/turbopuffer/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module Turbopuffer
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: Turbopuffer::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -276,9 +276,13 @@ module Turbopuffer
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                Turbopuffer::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end