turbopuffer 1.2.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f74c1ea6246584d6e391d41a0a1389cf2258bd6d47a36db1f93ed0b1722efb24
-  data.tar.gz: 754d17967417cd4767bd94563c99bb6b6eea2625d2d1ba440d49dd9ca19ee7c1
+  metadata.gz: 42eb95384e9c94a7cc1e8dfea77930d227c6b694f42894337432279a22236c99
+  data.tar.gz: 57c08feda85626bc9fbbd5198dba60455e379ba648ee59fb44e983dbae46b2eb
 SHA512:
-  metadata.gz: 91baba24abe1f1a02347206aea162b5ac024f5cc82a7fc37282e7d074258e0c4eaeeff1d8929597c5a1c2a6078dcfd24343fdb22a8df9d22bd3dcde418f790d8
-  data.tar.gz: 8a30736b4f51cf69ad85ec23736d08138025f198dc5d97b73e4f7baeb75625ca02701a38029af28294421fff747d18b1cad5f78262d69a75ab92833aca818a97
+  metadata.gz: 5d773caf2fe0e92fd6acf8effba09b5c3df6c54e074f269480d21d5dfd5a7a850e5a0f02ca943df2cf3ad6e2cbaa80b34ce8ad683d934ec6b0bcc858218e354a
+  data.tar.gz: 8e1433a207658e6a44e0b4591e67836c2ea88b1dea16e7c2509b4a8b0b7ba0abf30e296c7662fcdf72ee816b056ea2f9eed231190291f6c86751259473eb4a46

data/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 1.4.0 (2025-10-15)
+
+Full Changelog: [v1.3.0...v1.4.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.3.0...v1.4.0)
+
+### Features
+
+* Add float, []float and []bool to the list of valid types in the OpenAPI spec. ([0b809b3](https://github.com/turbopuffer/turbopuffer-ruby/commit/0b809b331e6a9e2121f440e26f47752ac2492459))
+* Promote disable_backpressure to first-class Write property ([96b020d](https://github.com/turbopuffer/turbopuffer-ruby/commit/96b020d754bfcef28e285c4fdb6c33aff85c502b))
+
+
+### Bug Fixes
+
+* absolutely qualified uris should always override the default ([7497b77](https://github.com/turbopuffer/turbopuffer-ruby/commit/7497b770a28cea22db5059aa1506ea316a445dc0))
+* always send `filename=...` for multipart requests where a file is expected ([155e39b](https://github.com/turbopuffer/turbopuffer-ruby/commit/155e39bd218655c654daa3815b67f373e7879730))
+* coroutine leaks from connection pool ([be9b5c2](https://github.com/turbopuffer/turbopuffer-ruby/commit/be9b5c20c1d73951996136b5db5ffb0f004e7530))
+* **internal:** use null byte as file separator in the fast formatting script ([c14be00](https://github.com/turbopuffer/turbopuffer-ruby/commit/c14be00b6284b7ba0c6167a1745b7f72077a7f3a))
+* shorten multipart boundary sep to less than RFC specificed max length ([a128bba](https://github.com/turbopuffer/turbopuffer-ruby/commit/a128bba556db8a9a0143ee64577c4bd2f5bbf495))
+* should not reuse buffers for `IO.copy_stream` interop ([e1d1753](https://github.com/turbopuffer/turbopuffer-ruby/commit/e1d1753c2dd07742617dfa605229581028fa34a8))
+
+
+### Performance Improvements
+
+* faster code formatting ([4b2b9b8](https://github.com/turbopuffer/turbopuffer-ruby/commit/4b2b9b87406f19b32283ed7ef4f5eea147b41ffb))
+
+
+### Chores
+
+* allow fast-format to use bsd sed as well ([9ba0c7d](https://github.com/turbopuffer/turbopuffer-ruby/commit/9ba0c7dd793d88af2e07d9ddfff1a2f49810ac65))
+* ignore linter error for tests having large collections ([c6a3403](https://github.com/turbopuffer/turbopuffer-ruby/commit/c6a34033c8a3476ebd0197c5435e637c9619a506))
+
+
+### Documentation
+
+* hint_cache_warm also update header and openapi ([91dd701](https://github.com/turbopuffer/turbopuffer-ruby/commit/91dd701d5221b5e245de2a14af0c5afcbee58123))
+
+## 1.3.0 (2025-09-19)
+
+Full Changelog: [v1.2.0...v1.3.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.2.0...v1.3.0)
+
+### Features
+
+* add WithParams variant to BM25 and ContainsAllTokens ([77c2acc](https://github.com/turbopuffer/turbopuffer-ruby/commit/77c2accb00d21ffa454dddd3e381c99082358098))
+
+
+### Chores
+
+* do not install brew dependencies in ./scripts/bootstrap by default ([923bcb0](https://github.com/turbopuffer/turbopuffer-ruby/commit/923bcb05ff927173b23edc446b075f456df4b332))
+
 ## 1.2.0 (2025-09-17)
 
 Full Changelog: [v1.1.0...v1.2.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.1.0...v1.2.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.2.0"
+gem "turbopuffer", "~> 1.4.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/file_part.rb

@@ -38,18 +38,21 @@ module Turbopuffer
     def to_yaml(*a) = read.to_yaml(*a)
 
     # @param content [Pathname, StringIO, IO, String]
-    # @param filename [String, nil]
+    # @param filename [Pathname, String, nil]
     # @param content_type [String, nil]
     def initialize(content, filename: nil, content_type: nil)
-      @content = content
+      @content_type = content_type
       @filename =
-        case content
-        in Pathname
-          filename.nil? ? content.basename.to_path : ::File.basename(filename)
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
         else
-          filename.nil? ? nil : ::File.basename(filename)
+          filename
         end
-      @content_type = content_type
     end
   end
 end

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

@@ -134,9 +134,9 @@ module Turbopuffer
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
+            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
@@ -149,7 +149,7 @@ module Turbopuffer
 
               self.class.calibrate_socket_timeout(conn, deadline)
               conn.request(req) do |rsp|
-                y << [conn, req, rsp]
+                y << [req, rsp]
                 break if finished
 
                 rsp.read_body do |bytes|
@@ -160,6 +160,8 @@ module Turbopuffer
                 end
                 eof = true
               end
+            ensure
+              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise Turbopuffer::Errors::APITimeoutError.new(url: url, request: req)
@@ -168,16 +170,11 @@ module Turbopuffer
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = Turbopuffer::Internal::Util.fused_enum(enum, external: true) do
             finished = true
-            tap do
-              enum.next
-            rescue StopIteration
-              nil
-            end
+            loop { enum.next }
           ensure
-            conn.finish if !eof && conn&.started?
             closing&.call
           end
           [Integer(response.code), response, body]

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

@@ -82,17 +82,20 @@ module Turbopuffer
           #
           # @return [Pathname, StringIO, IO, String, Object]
           def dump(value, state:)
-            # rubocop:disable Lint/DuplicateBranch
             case value
+            in StringIO | String
+              # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
+              # while not required, a filename is recommended, and in practice many servers do expect this
+              Turbopuffer::FilePart.new(value, filename: "upload")
             in IO
               state[:can_retry] = false
+              value.to_path.nil? ? Turbopuffer::FilePart.new(value, filename: "upload") : value
             in Turbopuffer::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
+              value
             else
+              value
             end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
           end
 
           # @api private

data/lib/turbopuffer/internal/util.rb

@@ -346,8 +346,9 @@ module Turbopuffer
           base_path, base_query = lhs.fetch_values(:path, :query)
           slashed = base_path.end_with?("/") ? base_path : "#{base_path}/"
 
-          parsed_path, parsed_query = parse_uri(rhs.fetch(:path)).fetch_values(:path, :query)
-          override = URI::Generic.build(**rhs.slice(:scheme, :host, :port), path: parsed_path)
+          merged = {**parse_uri(rhs.fetch(:path)), **rhs.except(:path, :query)}
+          parsed_path, parsed_query = merged.fetch_values(:path, :query)
+          override = URI::Generic.build(**merged.slice(:scheme, :host, :port), path: parsed_path)
 
           joined = URI.join(URI::Generic.build(lhs.except(:path, :query)), slashed, override)
           query = deep_merge(
@@ -473,10 +474,9 @@ module Turbopuffer
         # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
-            buf = String.new
             y.define_singleton_method(:write) do
-              self << buf.replace(_1)
-              buf.bytesize
+              self << _1.dup
+              _1.bytesize
             end
 
             blk.call(y)
@@ -566,7 +566,8 @@ module Turbopuffer
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
-          boundary = SecureRandom.urlsafe_base64(60)
+          # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
+          boundary = SecureRandom.urlsafe_base64(46)
 
           closing = []
           strio = writable_enum do |y|

data/lib/turbopuffer/models/attribute_schema.rb

@@ -6,7 +6,7 @@ module Turbopuffer
     module AttributeSchema
       extend Turbopuffer::Internal::Type::Union
 
-      # The data type of the attribute. Valid values: string, int, uint, uuid, datetime, bool, []string, []int, []uint, []uuid, []datetime, [DIMS]f16, [DIMS]f32.
+      # 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.
       variant -> { Turbopuffer::AttributeType }
 
       # Detailed configuration for an attribute attached to a document.

data/lib/turbopuffer/models/attribute_schema_config.rb

@@ -30,8 +30,9 @@ module Turbopuffer
       optional :regex, Turbopuffer::Internal::Type::Boolean
 
       # @!attribute type
-      #   The data type of the attribute. Valid values: string, int, uint, uuid, datetime,
-      #   bool, []string, []int, []uint, []uuid, []datetime, [DIMS]f16, [DIMS]f32.
+      #   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
@@ -50,7 +51,7 @@ module Turbopuffer
       #
       #   @param regex [Boolean] Whether to enable Regex filters on this attribute.
       #
-      #   @param type [String] The data type of the attribute. Valid values: string, int, uint, uuid, datetime,
+      #   @param type [String] The data type of the attribute. Valid values: string, int, uint, float, uuid, da
     end
   end
 end

data/lib/turbopuffer/models/bm25_clause_params.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class Bm25ClauseParams < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute last_as_prefix
+      #   Whether to treat the last token in the query input as a literal prefix.
+      #
+      #   @return [Boolean, nil]
+      optional :last_as_prefix, Turbopuffer::Internal::Type::Boolean
+
+      # @!method initialize(last_as_prefix: nil)
+      #   Additional (optional) parameters for a single BM25 query clause.
+      #
+      #   @param last_as_prefix [Boolean] Whether to treat the last token in the query input as a literal prefix.
+    end
+  end
+end

data/lib/turbopuffer/models/contains_all_tokens_filter_params.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class ContainsAllTokensFilterParams < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute last_as_prefix
+      #   Whether to treat the last token in the query input as a literal prefix.
+      #
+      #   @return [Boolean, nil]
+      optional :last_as_prefix, Turbopuffer::Internal::Type::Boolean
+
+      # @!method initialize(last_as_prefix: nil)
+      #   Additional (optional) parameters for the ContainsAllTokens filter.
+      #
+      #   @param last_as_prefix [Boolean] Whether to treat the last token in the query input as a literal prefix.
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_write_params.rb

@@ -36,6 +36,12 @@ module Turbopuffer
       #   @return [Array<String, Integer>, nil]
       optional :deletes, -> { Turbopuffer::Internal::Type::ArrayOf[union: Turbopuffer::ID] }
 
+      # @!attribute disable_backpressure
+      #   Disables write throttling (HTTP 429 responses) during high-volume ingestion.
+      #
+      #   @return [Boolean, nil]
+      optional :disable_backpressure, Turbopuffer::Internal::Type::Boolean
+
       # @!attribute distance_metric
       #   A function used to calculate vector similarity.
       #
@@ -92,7 +98,7 @@ module Turbopuffer
       #   @return [Array<Turbopuffer::Models::Row>, nil]
       optional :upsert_rows, -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Row] }
 
-      # @!method initialize(namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_condition: nil, deletes: nil, distance_metric: nil, encryption: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, schema: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
+      # @!method initialize(namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, schema: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceWriteParams} for more details.
       #
@@ -106,6 +112,8 @@ module Turbopuffer
       #
       #   @param deletes [Array<String, Integer>]
       #
+      #   @param disable_backpressure [Boolean] Disables write throttling (HTTP 429 responses) during high-volume ingestion.
+      #
       #   @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] A function used to calculate vector similarity.
       #
       #   @param encryption [Turbopuffer::Models::NamespaceWriteParams::Encryption] The encryption configuration for a namespace.

data/lib/turbopuffer/models.rb

@@ -48,10 +48,14 @@ module Turbopuffer
 
   AttributeType = Turbopuffer::Models::AttributeType
 
+  Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams
+
   ClientNamespacesParams = Turbopuffer::Models::ClientNamespacesParams
 
   Columns = Turbopuffer::Models::Columns
 
+  ContainsAllTokensFilterParams = Turbopuffer::Models::ContainsAllTokensFilterParams
+
   DistanceMetric = Turbopuffer::Models::DistanceMetric
 
   FullTextSearch = Turbopuffer::Models::FullTextSearch

data/lib/turbopuffer/resources/namespaces.rb

@@ -77,7 +77,7 @@ module Turbopuffer
         )
       end
 
-      # Warm the cache for a namespace.
+      # Signal turbopuffer to prepare for low-latency requests.
       #
       # @overload hint_cache_warm(namespace: nil, request_options: {})
       #
@@ -305,7 +305,7 @@ module Turbopuffer
       #
       # Create, update, or delete documents.
       #
-      # @overload write(namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_condition: nil, deletes: nil, distance_metric: nil, encryption: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, schema: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
+      # @overload write(namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, schema: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
@@ -317,6 +317,8 @@ module Turbopuffer
       #
       # @param deletes [Array<String, Integer>] Body param:
       #
+      # @param disable_backpressure [Boolean] Body param: Disables write throttling (HTTP 429 responses) during high-volume in
+      #
       # @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] Body param: A function used to calculate vector similarity.
       #
       # @param encryption [Turbopuffer::Models::NamespaceWriteParams::Encryption] Body param: The encryption configuration for a namespace.

data/lib/turbopuffer/version.rb

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

data/lib/turbopuffer.rb

@@ -55,8 +55,10 @@ require_relative "turbopuffer/models/aggregation_group"
 require_relative "turbopuffer/models/attribute_schema"
 require_relative "turbopuffer/models/attribute_schema_config"
 require_relative "turbopuffer/models/attribute_type"
+require_relative "turbopuffer/models/bm25_clause_params"
 require_relative "turbopuffer/models/client_namespaces_params"
 require_relative "turbopuffer/models/columns"
+require_relative "turbopuffer/models/contains_all_tokens_filter_params"
 require_relative "turbopuffer/models/distance_metric"
 require_relative "turbopuffer/models/full_text_search"
 require_relative "turbopuffer/models/full_text_search_config"

data/rbi/turbopuffer/file_part.rbi

@@ -27,7 +27,7 @@ module Turbopuffer
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end

data/rbi/turbopuffer/models/attribute_schema_config.rbi

@@ -48,8 +48,9 @@ module Turbopuffer
       sig { params(regex: T::Boolean).void }
       attr_writer :regex
 
-      # The data type of the attribute. Valid values: string, int, uint, uuid, datetime,
-      # bool, []string, []int, []uint, []uuid, []datetime, [DIMS]f16, [DIMS]f32.
+      # 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.
       sig { returns(T.nilable(String)) }
       attr_reader :type
 
@@ -78,8 +79,9 @@ module Turbopuffer
         full_text_search: nil,
         # Whether to enable Regex filters on this attribute.
         regex: nil,
-        # The data type of the attribute. Valid values: string, int, uint, uuid, datetime,
-        # bool, []string, []int, []uint, []uuid, []datetime, [DIMS]f16, [DIMS]f32.
+        # 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.
         type: nil
       )
       end

data/rbi/turbopuffer/models/bm25_clause_params.rbi

@@ -0,0 +1,31 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    class Bm25ClauseParams < Turbopuffer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Turbopuffer::Bm25ClauseParams, Turbopuffer::Internal::AnyHash)
+        end
+
+      # Whether to treat the last token in the query input as a literal prefix.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :last_as_prefix
+
+      sig { params(last_as_prefix: T::Boolean).void }
+      attr_writer :last_as_prefix
+
+      # Additional (optional) parameters for a single BM25 query clause.
+      sig { params(last_as_prefix: T::Boolean).returns(T.attached_class) }
+      def self.new(
+        # Whether to treat the last token in the query input as a literal prefix.
+        last_as_prefix: nil
+      )
+      end
+
+      sig { override.returns({ last_as_prefix: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models/contains_all_tokens_filter_params.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    class ContainsAllTokensFilterParams < Turbopuffer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Turbopuffer::ContainsAllTokensFilterParams,
+            Turbopuffer::Internal::AnyHash
+          )
+        end
+
+      # Whether to treat the last token in the query input as a literal prefix.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :last_as_prefix
+
+      sig { params(last_as_prefix: T::Boolean).void }
+      attr_writer :last_as_prefix
+
+      # Additional (optional) parameters for the ContainsAllTokens filter.
+      sig { params(last_as_prefix: T::Boolean).returns(T.attached_class) }
+      def self.new(
+        # Whether to treat the last token in the query input as a literal prefix.
+        last_as_prefix: nil
+      )
+      end
+
+      sig { override.returns({ last_as_prefix: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models/namespace_write_params.rbi

@@ -48,6 +48,13 @@ module Turbopuffer
       sig { params(deletes: T::Array[Turbopuffer::ID::Variants]).void }
       attr_writer :deletes
 
+      # Disables write throttling (HTTP 429 responses) during high-volume ingestion.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :disable_backpressure
+
+      sig { params(disable_backpressure: T::Boolean).void }
+      attr_writer :disable_backpressure
+
       # A function used to calculate vector similarity.
       sig { returns(T.nilable(Turbopuffer::DistanceMetric::OrSymbol)) }
       attr_reader :distance_metric
@@ -140,6 +147,7 @@ module Turbopuffer
           delete_by_filter: T.anything,
           delete_condition: T.anything,
           deletes: T::Array[Turbopuffer::ID::Variants],
+          disable_backpressure: T::Boolean,
           distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
           encryption: Turbopuffer::NamespaceWriteParams::Encryption::OrHash,
           patch_columns: Turbopuffer::Columns::OrHash,
@@ -166,6 +174,8 @@ module Turbopuffer
         # delete write. Only documents that pass the condition are deleted.
         delete_condition: nil,
         deletes: nil,
+        # Disables write throttling (HTTP 429 responses) during high-volume ingestion.
+        disable_backpressure: nil,
         # A function used to calculate vector similarity.
         distance_metric: nil,
         # The encryption configuration for a namespace.
@@ -198,6 +208,7 @@ module Turbopuffer
             delete_by_filter: T.anything,
             delete_condition: T.anything,
             deletes: T::Array[Turbopuffer::ID::Variants],
+            disable_backpressure: T::Boolean,
             distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
             encryption: Turbopuffer::NamespaceWriteParams::Encryption,
             patch_columns: Turbopuffer::Columns,

data/rbi/turbopuffer/models.rbi

@@ -13,10 +13,15 @@ module Turbopuffer
 
   AttributeType = Turbopuffer::Models::AttributeType
 
+  Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams
+
   ClientNamespacesParams = Turbopuffer::Models::ClientNamespacesParams
 
   Columns = Turbopuffer::Models::Columns
 
+  ContainsAllTokensFilterParams =
+    Turbopuffer::Models::ContainsAllTokensFilterParams
+
   DistanceMetric = Turbopuffer::Models::DistanceMetric
 
   FullTextSearch = Turbopuffer::Models::FullTextSearch

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -66,7 +66,7 @@ module Turbopuffer
       )
       end
 
-      # Warm the cache for a namespace.
+      # Signal turbopuffer to prepare for low-latency requests.
       sig do
         params(
           namespace: T.nilable(String),
@@ -240,6 +240,7 @@ module Turbopuffer
           delete_by_filter: T.anything,
           delete_condition: T.anything,
           deletes: T::Array[Turbopuffer::ID::Variants],
+          disable_backpressure: T::Boolean,
           distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
           encryption: Turbopuffer::NamespaceWriteParams::Encryption::OrHash,
           patch_columns: Turbopuffer::Columns::OrHash,
@@ -268,6 +269,9 @@ module Turbopuffer
         delete_condition: nil,
         # Body param:
         deletes: nil,
+        # Body param: Disables write throttling (HTTP 429 responses) during high-volume
+        # ingestion.
+        disable_backpressure: nil,
         # Body param: A function used to calculate vector similarity.
         distance_metric: nil,
         # Body param: The encryption configuration for a namespace.

data/sig/turbopuffer/file_part.rbs

@@ -14,7 +14,7 @@ module Turbopuffer
 
     def initialize: (
       Pathname | StringIO | IO | String content,
-      ?filename: String?,
+      ?filename: (Pathname | String)?,
       ?content_type: String?
     ) -> void
   end

data/sig/turbopuffer/models/bm25_clause_params.rbs

@@ -0,0 +1,15 @@
+module Turbopuffer
+  module Models
+    type bm25_clause_params = { last_as_prefix: bool }
+
+    class Bm25ClauseParams < Turbopuffer::Internal::Type::BaseModel
+      attr_reader last_as_prefix: bool?
+
+      def last_as_prefix=: (bool) -> bool
+
+      def initialize: (?last_as_prefix: bool) -> void
+
+      def to_hash: -> { last_as_prefix: bool }
+    end
+  end
+end

data/sig/turbopuffer/models/contains_all_tokens_filter_params.rbs

@@ -0,0 +1,15 @@
+module Turbopuffer
+  module Models
+    type contains_all_tokens_filter_params = { last_as_prefix: bool }
+
+    class ContainsAllTokensFilterParams < Turbopuffer::Internal::Type::BaseModel
+      attr_reader last_as_prefix: bool?
+
+      def last_as_prefix=: (bool) -> bool
+
+      def initialize: (?last_as_prefix: bool) -> void
+
+      def to_hash: -> { last_as_prefix: bool }
+    end
+  end
+end

data/sig/turbopuffer/models/namespace_write_params.rbs

@@ -7,6 +7,7 @@ module Turbopuffer
         delete_by_filter: top,
         delete_condition: top,
         deletes: ::Array[Turbopuffer::Models::id],
+        disable_backpressure: bool,
         distance_metric: Turbopuffer::Models::distance_metric,
         encryption: Turbopuffer::NamespaceWriteParams::Encryption,
         patch_columns: Turbopuffer::Columns,
@@ -45,6 +46,10 @@ module Turbopuffer
         ::Array[Turbopuffer::Models::id]
       ) -> ::Array[Turbopuffer::Models::id]
 
+      attr_reader disable_backpressure: bool?
+
+      def disable_backpressure=: (bool) -> bool
+
       attr_reader distance_metric: Turbopuffer::Models::distance_metric?
 
       def distance_metric=: (
@@ -93,6 +98,7 @@ module Turbopuffer
         ?delete_by_filter: top,
         ?delete_condition: top,
         ?deletes: ::Array[Turbopuffer::Models::id],
+        ?disable_backpressure: bool,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?encryption: Turbopuffer::NamespaceWriteParams::Encryption,
         ?patch_columns: Turbopuffer::Columns,
@@ -111,6 +117,7 @@ module Turbopuffer
         delete_by_filter: top,
         delete_condition: top,
         deletes: ::Array[Turbopuffer::Models::id],
+        disable_backpressure: bool,
         distance_metric: Turbopuffer::Models::distance_metric,
         encryption: Turbopuffer::NamespaceWriteParams::Encryption,
         patch_columns: Turbopuffer::Columns,

data/sig/turbopuffer/models.rbs

@@ -7,10 +7,14 @@ module Turbopuffer
 
   class AttributeType = Turbopuffer::Models::AttributeType
 
+  class Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams
+
   class ClientNamespacesParams = Turbopuffer::Models::ClientNamespacesParams
 
   class Columns = Turbopuffer::Models::Columns
 
+  class ContainsAllTokensFilterParams = Turbopuffer::Models::ContainsAllTokensFilterParams
+
   module DistanceMetric = Turbopuffer::Models::DistanceMetric
 
   module FullTextSearch = Turbopuffer::Models::FullTextSearch

data/sig/turbopuffer/resources/namespaces.rbs

@@ -81,6 +81,7 @@ module Turbopuffer
         ?delete_by_filter: top,
         ?delete_condition: top,
         ?deletes: ::Array[Turbopuffer::Models::id],
+        ?disable_backpressure: bool,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?encryption: Turbopuffer::NamespaceWriteParams::Encryption,
         ?patch_columns: Turbopuffer::Columns,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-17 00:00:00.000000000 Z
+date: 2025-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -60,8 +60,10 @@ files:
 - lib/turbopuffer/models/attribute_schema.rb
 - lib/turbopuffer/models/attribute_schema_config.rb
 - lib/turbopuffer/models/attribute_type.rb
+- lib/turbopuffer/models/bm25_clause_params.rb
 - lib/turbopuffer/models/client_namespaces_params.rb
 - lib/turbopuffer/models/columns.rb
+- lib/turbopuffer/models/contains_all_tokens_filter_params.rb
 - lib/turbopuffer/models/distance_metric.rb
 - lib/turbopuffer/models/full_text_search.rb
 - lib/turbopuffer/models/full_text_search_config.rb
@@ -126,8 +128,10 @@ files:
 - rbi/turbopuffer/models/attribute_schema.rbi
 - rbi/turbopuffer/models/attribute_schema_config.rbi
 - rbi/turbopuffer/models/attribute_type.rbi
+- rbi/turbopuffer/models/bm25_clause_params.rbi
 - rbi/turbopuffer/models/client_namespaces_params.rbi
 - rbi/turbopuffer/models/columns.rbi
+- rbi/turbopuffer/models/contains_all_tokens_filter_params.rbi
 - rbi/turbopuffer/models/distance_metric.rbi
 - rbi/turbopuffer/models/full_text_search.rbi
 - rbi/turbopuffer/models/full_text_search_config.rbi
@@ -191,8 +195,10 @@ files:
 - sig/turbopuffer/models/attribute_schema.rbs
 - sig/turbopuffer/models/attribute_schema_config.rbs
 - sig/turbopuffer/models/attribute_type.rbs
+- sig/turbopuffer/models/bm25_clause_params.rbs
 - sig/turbopuffer/models/client_namespaces_params.rbs
 - sig/turbopuffer/models/columns.rbs
+- sig/turbopuffer/models/contains_all_tokens_filter_params.rbs
 - sig/turbopuffer/models/distance_metric.rbs
 - sig/turbopuffer/models/full_text_search.rbs
 - sig/turbopuffer/models/full_text_search_config.rbs