turbopuffer 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20d0c90e03716bcf7ca9387385505eb4bd4711888f16eb0d3bde30d70ad0829a
-  data.tar.gz: 29b6153b4c7250a63170be4c7b1010933ef7c96e7817fd78de6d4790fed8a481
+  metadata.gz: a3a51779391cbefbadc2c92d4da69e9f2b8a16db31b09626fc610d979f8317af
+  data.tar.gz: f814addde33fea46dfea6c616ab8f71c34a4813a7f53283bdd3b04765ea9f91b
 SHA512:
-  metadata.gz: b7243b9b3134d2fa3741ed94b79c5813f4d23a5f106d561865a8a9e1891ac76c7cb0d66088bbb3e2b9f0f1970ed023bffc06a9c98059ac8af9e0b8f544b0249d
-  data.tar.gz: f249a2b3afa1092d5bab4ea3510ee6de24719b8e61fbbcc5975f90e6d6ecbc002298283454f0f1eccf9c313f9f7def328b6f508df894f9a852ae3759d8b6ac66
+  metadata.gz: 66b621f09d12e2ae0540a69f163c596063b59c3a4df34416cd9c48330f167065af3ee4e1292d1d954adcfc7796b1d1a46fd023b50681f286d81e1984535e5880
+  data.tar.gz: 9b77397676c00954fd6ee3bad008eeedf6af798d41718d636841b9e12c35ab98caa434acaee6f157e006d9d08aa6491df57943ebfe8fa846fbcc131102a8d957

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 2.3.0 (2026-06-16)
+
+Full Changelog: [v2.2.0...v2.3.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.2.0...v2.3.0)
+
+### Features
+
+* tpuf-engine: support dest_encryption in copy_from_namespace ([ef8ce32](https://github.com/turbopuffer/turbopuffer-ruby/commit/ef8ce322607fe8fd30b259d5012582b776ec1b09))
+
+
+### Bug Fixes
+
+* **client:** send content-type header for requests with an omitted optional body ([d2c5ed1](https://github.com/turbopuffer/turbopuffer-ruby/commit/d2c5ed1ec19aa3c371c1bce215f9b77ac5910dd7))
+
+
+### Documentation
+
+* rename /docs/overview to /docs/api-overview ([c049a0c](https://github.com/turbopuffer/turbopuffer-ruby/commit/c049a0c4a712f9de2081da5f387a8036acc04fcf))
+
+## 2.2.0 (2026-06-08)
+
+Full Changelog: [v2.1.0...v2.2.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.1.0...v2.2.0)
+
+### Features
+
+* stainless: update sdks to support case-insensitive fuzzy filter ([d02bb79](https://github.com/turbopuffer/turbopuffer-ruby/commit/d02bb79d809f3b2285020f3aac4a3441ac1e38b2))
+* transparent async polling ([#61](https://github.com/turbopuffer/turbopuffer-ruby/issues/61)) ([d93c499](https://github.com/turbopuffer/turbopuffer-ruby/commit/d93c49924d0df4bb4be9935f2090ce6fa26da18e))
+
 ## 2.1.0 (2026-06-03)
 
 Full Changelog: [v2.1.0-alpha.1...v2.1.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.1.0-alpha.1...v2.1.0)

data/README.md

@@ -17,7 +17,7 @@ Use the turbopuffer MCP Server to enable AI assistants to interact with this API
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/turbopuffer).
 
-The REST API documentation can be found at [turbopuffer.com/docs/overview](https://turbopuffer.com/docs/overview).
+The REST API documentation can be found at [turbopuffer.com/docs/api-overview](https://turbopuffer.com/docs/api-overview).
 
 ## Installation
 
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "turbopuffer", "~> 2.1.0"
+gem "turbopuffer", "~> 2.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/internal/respond_async.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Internal
+    # Support for transparent polling of async tpuf APIs.
+    #
+    # Every API request is stamped with `Prefer: respond-async`. If the server
+    # applies the preference (i.e. responds with `202 Accepted` +
+    # `preference-applied: respond-async`) the SDK polls that URL until the
+    # operation finishes and returns the final result as if the API call had
+    # been synchronous.
+    #
+    # @api private
+    module RespondAsync
+      HEADER_PREFER = "prefer"
+      HEADER_PREFERENCE_APPLIED = "preference-applied"
+      HEADER_LOCATION = "location"
+      RESPOND_ASYNC = "respond-async"
+
+      POLL_INTERVAL = 1.0
+      POLL_REQUEST_TIMEOUT = 60.0
+
+      # Timeout tracking for async polling.
+      #
+      # @api private
+      class Timeout
+        # @param timeout [Float]
+        def initialize(timeout)
+          @deadline = Turbopuffer::Internal::Util.monotonic_secs + timeout
+        end
+
+        # @return [Float]
+        def remaining
+          [@deadline - Turbopuffer::Internal::Util.monotonic_secs, 0].max
+        end
+
+        # @return [Float]
+        def poll_timeout
+          [remaining, POLL_REQUEST_TIMEOUT].min
+        end
+
+        # @return [Float]
+        def sleep_duration
+          [remaining, POLL_INTERVAL].min
+        end
+      end
+
+      class << self
+        # @param headers [Hash{String=>String}]
+        #
+        # @return [void]
+        def prepare_headers(headers)
+          headers[HEADER_PREFER] ||= RESPOND_ASYNC
+        end
+
+        # @param client [Turbopuffer::Internal::Transport::BaseClient]
+        # @param request [Hash{Symbol=>Object}] the original built request
+        # @param response [Net::HTTPResponse]
+        # @param stream [Enumerable<String>]
+        #
+        # @return [Array(Integer, Net::HTTPResponse, Enumerable<String>)]
+        def maybe_poll(client, request, response, stream)
+          return [Integer(response.code), response, stream] unless respond_async_applied?(response)
+
+          # Drain the original 202 body so the connection returns to the pool.
+          stream&.each { next }
+
+          orig_url = request.fetch(:url)
+          location = extract_location(orig_url, response)
+
+          timeout = Timeout.new(request.fetch(:timeout))
+
+          loop do
+            result = poll_once(client, orig_url, location, timeout)
+            return result if result
+          end
+        end
+
+        private
+
+        # @param response [Net::HTTPResponse]
+        #
+        # @return [Boolean]
+        def respond_async_applied?(response)
+          return false unless response.code == "202"
+
+          applied = response[HEADER_PREFERENCE_APPLIED].to_s
+          applied.strip.downcase == RESPOND_ASYNC
+        end
+
+        # @param orig_url [URI::Generic]
+        # @param response [Net::HTTPResponse]
+        #
+        # @return [URI::Generic]
+        def extract_location(orig_url, response)
+          raw_location = response[HEADER_LOCATION].to_s.strip
+          if raw_location.empty?
+            raise Turbopuffer::Errors::APIError.new(
+              url: orig_url,
+              message: "Server returned async response without a 'Location' header."
+            )
+          end
+
+          # Normalize so the default port for the scheme is applied.
+          orig = URI(orig_url.to_s)
+
+          # Resolve the Location against the original request URL.
+          begin
+            location = URI.join(orig, raw_location)
+          rescue URI::InvalidURIError
+            raise Turbopuffer::Errors::APIError.new(
+              url: orig_url,
+              message: "malformed 'Location' header: #{raw_location.inspect}"
+            )
+          end
+
+          if [location.scheme, location.host, location.port] !=
+             [orig.scheme, orig.host, orig.port]
+            raise Turbopuffer::Errors::APIError.new(
+              url: orig_url,
+              message: "'Location' origin does not match request origin: #{raw_location.inspect}"
+            )
+          end
+
+          location
+        end
+
+        # @param client [Turbopuffer::Internal::Transport::BaseClient]
+        # @param orig_url [URI::Generic]
+        # @param location [URI::Generic]
+        # @param timeout [Timeout]
+        #
+        # @return [Array(Integer, Net::HTTPResponse, Array<String>), nil]
+        def poll_once(client, orig_url, location, timeout)
+          raise Turbopuffer::Errors::APITimeoutError.new(url: orig_url) if timeout.remaining.zero?
+
+          body =
+            begin
+              client.request(
+                method: :get,
+                path: location.request_uri,
+                model: Turbopuffer::Internal::Type::Unknown,
+                options: {
+                  extra_headers: {HEADER_PREFER => ""},
+                  timeout: timeout.poll_timeout
+                }
+              )
+            rescue JSON::ParserError => e
+              raise Turbopuffer::Errors::APIError.new(
+                url: orig_url,
+                message: "malformed poll response: #{e.message}"
+              )
+            end
+
+          case body
+          in {status: "running"}
+            sleep(timeout.sleep_duration)
+            nil
+          in {status: "finished", result: {success: success}}
+            response = Net::HTTPOK.new("1.1", 200, "OK")
+            response["content-type"] = "application/json"
+            [200, response, [JSON.generate(success)]]
+          in {status: "finished", result: {error: {status_code: Integer => err_status, **rest}}}
+            raise Turbopuffer::Errors::APIStatusError.for(
+              url: orig_url,
+              status: err_status,
+              headers: nil,
+              body: rest[:detail],
+              request: nil,
+              response: nil
+            )
+          else
+            raise Turbopuffer::Errors::APIError.new(
+              url: orig_url,
+              message: "malformed poll response: #{body.inspect}"
+            )
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -309,6 +309,8 @@ module Turbopuffer
             headers["x-stainless-timeout"] = timeout.to_s
           end
 
+          Turbopuffer::Internal::RespondAsync.prepare_headers(headers)
+
           headers.reject! { |_, v| v.to_s.empty? }
 
           body =
@@ -319,7 +321,10 @@ module Turbopuffer
               Turbopuffer::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
-          headers.delete("content-type") if body.nil?
+          # Generated methods always pass `req[:body]` for operations that define a
+          # request body, so only elide the content-type header when the operation
+          # has no body at all, not when an optional body param was omitted.
+          headers.delete("content-type") if body.nil? && !req.key?(:body)
 
           url = Turbopuffer::Internal::Util.join_parsed_uri(
             @base_url_components,
@@ -501,12 +506,18 @@ module Turbopuffer
 
           # Don't send the current retry count in the headers if the caller modified the header defaults.
           send_retry_header = request.fetch(:headers)["x-stainless-retry-count"] == "0"
-          status, response, stream = send_request(
+          _, response, stream = send_request(
             request,
             redirect_count: 0,
             retry_count: 0,
             send_retry_header: send_retry_header
           )
+          status, response, stream = Turbopuffer::Internal::RespondAsync.maybe_poll(
+            self,
+            request,
+            response,
+            stream
+          )
 
           headers = Turbopuffer::Internal::Util.normalized_headers(response.each_header.to_h)
           decoded = Turbopuffer::Internal::Util.decode_content(headers, stream: stream)

data/lib/turbopuffer/models/fuzzy_params.rb

@@ -11,13 +11,22 @@ module Turbopuffer
       required :max_edit_distance,
                -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::FuzzyMaxEditDistance] }
 
-      # @!method initialize(max_edit_distance:)
+      # @!attribute case_sensitive
+      #   Whether searching with Fuzzy filter is case-sensitive. Defaults to `true` (i.e.
+      #   case-sensitive).
+      #
+      #   @return [Boolean, nil]
+      optional :case_sensitive, Turbopuffer::Internal::Type::Boolean
+
+      # @!method initialize(max_edit_distance:, case_sensitive: nil)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::FuzzyParams} for more details.
       #
       #   Additional parameters for the Fuzzy filter.
       #
       #   @param max_edit_distance [Array<Turbopuffer::Models::FuzzyMaxEditDistance>] Maximum edit distance allowed at each query length. Queries shorter than the fir
+      #
+      #   @param case_sensitive [Boolean] Whether searching with Fuzzy filter is case-sensitive. Defaults to `true` (i.e.
     end
   end
 end

data/lib/turbopuffer/models/namespace_copy_from_params.rb

@@ -18,6 +18,12 @@ module Turbopuffer
       #   @return [String]
       required :source_namespace, String
 
+      # @!attribute dest_encryption
+      #   (Optional) The encryption configuration for the destination namespace.
+      #
+      #   @return [Turbopuffer::Models::Encryption::CustomerManaged, Turbopuffer::Models::Encryption::Default, nil]
+      optional :dest_encryption, union: -> { Turbopuffer::Encryption }
+
       # @!attribute source_api_key
       #   (Optional) An API key for the organization containing the source namespace
       #
@@ -30,11 +36,13 @@ module Turbopuffer
       #   @return [String, nil]
       optional :source_region, String
 
-      # @!method initialize(source_namespace:, namespace: nil, source_api_key: nil, source_region: nil, request_options: {})
+      # @!method initialize(source_namespace:, namespace: nil, dest_encryption: nil, source_api_key: nil, source_region: nil, request_options: {})
       #   @param source_namespace [String] The namespace to copy documents from.
       #
       #   @param namespace [String]
       #
+      #   @param dest_encryption [Turbopuffer::Models::Encryption::CustomerManaged, Turbopuffer::Models::Encryption::Default] (Optional) The encryption configuration for the destination namespace.
+      #
       #   @param source_api_key [String] (Optional) An API key for the organization containing the source namespace
       #
       #   @param source_region [String] (Optional) The region of the source namespace.

data/lib/turbopuffer/resources/namespaces.rb

@@ -36,12 +36,14 @@ module Turbopuffer
       #
       # Copy all documents from another namespace into this one.
       #
-      # @overload copy_from(source_namespace:, namespace: nil, source_api_key: nil, source_region: nil, request_options: {})
+      # @overload copy_from(source_namespace:, namespace: nil, dest_encryption: nil, source_api_key: nil, source_region: nil, request_options: {})
       #
       # @param source_namespace [String] Body param: The namespace to copy documents from.
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
+      # @param dest_encryption [Turbopuffer::Models::Encryption::CustomerManaged, Turbopuffer::Models::Encryption::Default] Body param: (Optional) The encryption configuration for the destination namespac
+      #
       # @param source_api_key [String] Body param: (Optional) An API key for the organization containing the source nam
       #
       # @param source_region [String] Body param: (Optional) The region of the source namespace.

data/lib/turbopuffer/version.rb

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

data/lib/turbopuffer.rb

@@ -51,6 +51,7 @@ require_relative "turbopuffer/file_part"
 require_relative "turbopuffer/errors"
 require_relative "turbopuffer/internal/transport/base_client"
 require_relative "turbopuffer/internal/transport/pooled_net_requester"
+require_relative "turbopuffer/internal/respond_async"
 require_relative "turbopuffer/client"
 require_relative "turbopuffer/internal/namespace_page"
 require_relative "turbopuffer/models/pinning_config"

data/rbi/turbopuffer/models/fuzzy_params.rbi

@@ -13,22 +13,38 @@ module Turbopuffer
       sig { returns(T::Array[Turbopuffer::FuzzyMaxEditDistance]) }
       attr_accessor :max_edit_distance
 
+      # Whether searching with Fuzzy filter is case-sensitive. Defaults to `true` (i.e.
+      # case-sensitive).
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :case_sensitive
+
+      sig { params(case_sensitive: T::Boolean).void }
+      attr_writer :case_sensitive
+
       # Additional parameters for the Fuzzy filter.
       sig do
         params(
-          max_edit_distance: T::Array[Turbopuffer::FuzzyMaxEditDistance::OrHash]
+          max_edit_distance:
+            T::Array[Turbopuffer::FuzzyMaxEditDistance::OrHash],
+          case_sensitive: T::Boolean
         ).returns(T.attached_class)
       end
       def self.new(
         # Maximum edit distance allowed at each query length. Queries shorter than the
         # first threshold return no matches.
-        max_edit_distance:
+        max_edit_distance:,
+        # Whether searching with Fuzzy filter is case-sensitive. Defaults to `true` (i.e.
+        # case-sensitive).
+        case_sensitive: nil
       )
       end
 
       sig do
         override.returns(
-          { max_edit_distance: T::Array[Turbopuffer::FuzzyMaxEditDistance] }
+          {
+            max_edit_distance: T::Array[Turbopuffer::FuzzyMaxEditDistance],
+            case_sensitive: T::Boolean
+          }
         )
       end
       def to_hash

data/rbi/turbopuffer/models/namespace_copy_from_params.rbi

@@ -24,6 +24,30 @@ module Turbopuffer
       sig { returns(String) }
       attr_accessor :source_namespace
 
+      # (Optional) The encryption configuration for the destination namespace.
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              Turbopuffer::Encryption::CustomerManaged,
+              Turbopuffer::Encryption::Default
+            )
+          )
+        )
+      end
+      attr_reader :dest_encryption
+
+      sig do
+        params(
+          dest_encryption:
+            T.any(
+              Turbopuffer::Encryption::CustomerManaged::OrHash,
+              Turbopuffer::Encryption::Default::OrHash
+            )
+        ).void
+      end
+      attr_writer :dest_encryption
+
       # (Optional) An API key for the organization containing the source namespace
       sig { returns(T.nilable(String)) }
       attr_reader :source_api_key
@@ -42,6 +66,11 @@ module Turbopuffer
         params(
           source_namespace: String,
           namespace: String,
+          dest_encryption:
+            T.any(
+              Turbopuffer::Encryption::CustomerManaged::OrHash,
+              Turbopuffer::Encryption::Default::OrHash
+            ),
           source_api_key: String,
           source_region: String,
           request_options: Turbopuffer::RequestOptions::OrHash
@@ -51,6 +80,8 @@ module Turbopuffer
         # The namespace to copy documents from.
         source_namespace:,
         namespace: nil,
+        # (Optional) The encryption configuration for the destination namespace.
+        dest_encryption: nil,
         # (Optional) An API key for the organization containing the source namespace
         source_api_key: nil,
         # (Optional) The region of the source namespace.
@@ -64,6 +95,11 @@ module Turbopuffer
           {
             namespace: String,
             source_namespace: String,
+            dest_encryption:
+              T.any(
+                Turbopuffer::Encryption::CustomerManaged,
+                Turbopuffer::Encryption::Default
+              ),
             source_api_key: String,
             source_region: String,
             request_options: Turbopuffer::RequestOptions

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -25,6 +25,11 @@ module Turbopuffer
         params(
           source_namespace: String,
           namespace: String,
+          dest_encryption:
+            T.any(
+              Turbopuffer::Encryption::CustomerManaged::OrHash,
+              Turbopuffer::Encryption::Default::OrHash
+            ),
           source_api_key: String,
           source_region: String,
           request_options: Turbopuffer::RequestOptions::OrHash
@@ -35,6 +40,9 @@ module Turbopuffer
         source_namespace:,
         # Path param: The name of the namespace.
         namespace: nil,
+        # Body param: (Optional) The encryption configuration for the destination
+        # namespace.
+        dest_encryption: nil,
         # Body param: (Optional) An API key for the organization containing the source
         # namespace
         source_api_key: nil,

data/sig/turbopuffer/models/fuzzy_params.rbs

@@ -1,17 +1,26 @@
 module Turbopuffer
   module Models
     type fuzzy_params =
-      { max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance] }
+      {
+        max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance],
+        case_sensitive: bool
+      }
 
     class FuzzyParams < Turbopuffer::Internal::Type::BaseModel
       attr_accessor max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance]
 
+      attr_reader case_sensitive: bool?
+
+      def case_sensitive=: (bool) -> bool
+
       def initialize: (
-        max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance]
+        max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance],
+        ?case_sensitive: bool
       ) -> void
 
       def to_hash: -> {
-        max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance]
+        max_edit_distance: ::Array[Turbopuffer::FuzzyMaxEditDistance],
+        case_sensitive: bool
       }
     end
   end

data/sig/turbopuffer/models/namespace_copy_from_params.rbs

@@ -4,6 +4,7 @@ module Turbopuffer
       {
         namespace: String,
         source_namespace: String,
+        dest_encryption: Turbopuffer::Models::encryption,
         source_api_key: String,
         source_region: String
       }
@@ -19,6 +20,12 @@ module Turbopuffer
 
       attr_accessor source_namespace: String
 
+      attr_reader dest_encryption: Turbopuffer::Models::encryption?
+
+      def dest_encryption=: (
+        Turbopuffer::Models::encryption
+      ) -> Turbopuffer::Models::encryption
+
       attr_reader source_api_key: String?
 
       def source_api_key=: (String) -> String
@@ -30,6 +37,7 @@ module Turbopuffer
       def initialize: (
         source_namespace: String,
         ?namespace: String,
+        ?dest_encryption: Turbopuffer::Models::encryption,
         ?source_api_key: String,
         ?source_region: String,
         ?request_options: Turbopuffer::request_opts
@@ -38,6 +46,7 @@ module Turbopuffer
       def to_hash: -> {
         namespace: String,
         source_namespace: String,
+        dest_encryption: Turbopuffer::Models::encryption,
         source_api_key: String,
         source_region: String,
         request_options: Turbopuffer::RequestOptions

data/sig/turbopuffer/resources/namespaces.rbs

@@ -10,6 +10,7 @@ module Turbopuffer
       def copy_from: (
         source_namespace: String,
         ?namespace: String,
+        ?dest_encryption: Turbopuffer::Models::encryption,
         ?source_api_key: String,
         ?source_region: String,
         ?request_options: Turbopuffer::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-03 00:00:00.000000000 Z
+date: 2026-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -55,6 +55,7 @@ files:
 - lib/turbopuffer/file_part.rb
 - lib/turbopuffer/internal.rb
 - lib/turbopuffer/internal/namespace_page.rb
+- lib/turbopuffer/internal/respond_async.rb
 - lib/turbopuffer/internal/transport/base_client.rb
 - lib/turbopuffer/internal/transport/pooled_net_requester.rb
 - lib/turbopuffer/internal/type/array_of.rb