turbopuffer 1.3.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a44d9957aa604246bc7493029cce8afe362db53c55f1f81d95eb69b39c5ff7ac
-  data.tar.gz: 7a948b08d3604d1e2be35ad9cf1311d17bbad416836fa28678e6e8b4710b817b
+  metadata.gz: a2f5759ef6a54d8d20fd914a7afb761b2f63e9383fe76094336a59d2dd77c887
+  data.tar.gz: 6186eaa83038a13743abdc63737933c49666249bf4435067551ac1271c47202e
 SHA512:
-  metadata.gz: 0cfc63859cdd9ac68a24317c05adffdbd914c3cb9123e93a33630b717f67396d693034c81bea328edf595aef47e0189aa78cf1389702c5685027a5c04bbc96bf
-  data.tar.gz: c7f529a49e1866494cd4660505864ce6d0aeb075416643c32642377ca560986c9f1f30abab1cb2565e406fed7f4e9462f23a6a2dd453898ecc7af1e1ba8161f0
+  metadata.gz: 6c1dc39006702ca0bdba4684355c7c4436522fd796c33031b553523808b2ae6486bbc5865a1e55d5986ccafa837c6ac914319f9171914e1391ff9c9e527f116d
+  data.tar.gz: 5b77e8508f24ffbac98423426cc270e812f6ef434d50ceab6397cb8b905e4e4e4a8a2f52f62b84c4051afc2955899f74c39cec35ef6039386eae837567ed5908

data/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* Metadata endpoint updates (e.g. to track indexing progress) ([4e631c7](https://github.com/turbopuffer/turbopuffer-ruby/commit/4e631c73375f784d2be0b7acb58c75d336cf1b2c))
+* required for patch_by_filter :facepalm: ([f075887](https://github.com/turbopuffer/turbopuffer-ruby/commit/f0758879e11152cec2506509b5e558c1a6e143c8))
+* stainless: add patch_by_filter ([da661c2](https://github.com/turbopuffer/turbopuffer-ruby/commit/da661c2d9bf4e8eaf3b70ea9430d22998188a02e))
+
+## 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)

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.3.0"
+gem "turbopuffer", "~> 1.5.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/namespace_metadata.rb

@@ -28,7 +28,28 @@ module Turbopuffer
       #   @return [Hash{Symbol=>Turbopuffer::Models::AttributeSchemaConfig}]
       required :schema, -> { Turbopuffer::Internal::Type::HashOf[Turbopuffer::AttributeSchemaConfig] }
 
-      # @!method initialize(approx_logical_bytes:, approx_row_count:, created_at:, schema:)
+      # @!attribute updated_at
+      #   The timestamp when the namespace was last modified by a write operation.
+      #
+      #   @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)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::NamespaceMetadata} for more details.
+      #
       #   Metadata about a namespace.
       #
       #   @param approx_logical_bytes [Integer] The approximate number of logical bytes in the namespace.
@@ -38,6 +59,97 @@ 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 updated_at [Time] The timestamp when the namespace was last modified by a write operation.
+      #
+      #   @param encryption [Boolean, Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek] Indicates that the namespace is encrypted with a customer-managed encryption key
+      #
+      #   @param index [Turbopuffer::Models::NamespaceMetadata::Index::Status, Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1]
+
+      # Indicates that the namespace is encrypted with a customer-managed encryption key
+      # (CMEK).
+      #
+      # @see Turbopuffer::Models::NamespaceMetadata#encryption
+      module Encryption
+        extend Turbopuffer::Internal::Type::Union
+
+        variant Turbopuffer::Internal::Type::Boolean
+
+        # Indicates that the namespace is encrypted with a customer-managed encryption key (CMEK).
+        variant -> { Turbopuffer::NamespaceMetadata::Encryption::Cmek }
+
+        class Cmek < Turbopuffer::Internal::Type::BaseModel
+          # @!attribute cmek
+          #
+          #   @return [Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek::Cmek, nil]
+          optional :cmek, -> { Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek }
+
+          # @!method initialize(cmek: nil)
+          #   Indicates that the namespace is encrypted with a customer-managed encryption key
+          #   (CMEK).
+          #
+          #   @param cmek [Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek::Cmek]
+
+          # @see Turbopuffer::Models::NamespaceMetadata::Encryption::Cmek#cmek
+          class Cmek < Turbopuffer::Internal::Type::BaseModel
+            # @!attribute key_name
+            #   The name of the CMEK key in use.
+            #
+            #   @return [String]
+            required :key_name, String
+
+            # @!method initialize(key_name:)
+            #   @param key_name [String] The name of the CMEK key in use.
+          end
+        end
+
+        # @!method self.variants
+        #   @return [Array(Boolean, 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::UnionMember1 }
+
+        class Status < Turbopuffer::Internal::Type::BaseModel
+          # @!attribute status
+          #
+          #   @return [Symbol, :"up-to-date"]
+          required :status, const: :"up-to-date"
+
+          # @!method initialize(status: :"up-to-date")
+          #   @param status [Symbol, :"up-to-date"]
+        end
+
+        class UnionMember1 < Turbopuffer::Internal::Type::BaseModel
+          # @!attribute status
+          #
+          #   @return [Symbol, :updating]
+          required :status, const: :updating
+
+          # @!attribute unindexed_bytes
+          #   The number of bytes in the namespace that are in the write-ahead log but have
+          #   not yet been indexed.
+          #
+          #   @return [Integer]
+          required :unindexed_bytes, Integer
+
+          # @!method initialize(unindexed_bytes:, status: :updating)
+          #   Some parameter documentations has been truncated, see
+          #   {Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1} for more details.
+          #
+          #   @param unindexed_bytes [Integer] The number of bytes in the namespace that are in the write-ahead log but have no
+          #
+          #   @param status [Symbol, :updating]
+        end
+
+        # @!method self.variants
+        #   @return [Array(Turbopuffer::Models::NamespaceMetadata::Index::Status, Turbopuffer::Models::NamespaceMetadata::Index::UnionMember1)]
+      end
     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.
       #
@@ -48,6 +54,12 @@ module Turbopuffer
       #   @return [Turbopuffer::Models::NamespaceWriteParams::Encryption, nil]
       optional :encryption, -> { Turbopuffer::NamespaceWriteParams::Encryption }
 
+      # @!attribute patch_by_filter
+      #   The patch and filter specifying which documents to patch.
+      #
+      #   @return [Turbopuffer::Models::NamespaceWriteParams::PatchByFilter, nil]
+      optional :patch_by_filter, -> { Turbopuffer::NamespaceWriteParams::PatchByFilter }
+
       # @!attribute patch_columns
       #   A list of documents in columnar format. Each key is a column name, mapped to an
       #   array of values for that column.
@@ -92,7 +104,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_by_filter: 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,10 +118,14 @@ 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.
       #
+      #   @param patch_by_filter [Turbopuffer::Models::NamespaceWriteParams::PatchByFilter] The patch and filter specifying which documents to patch.
+      #
       #   @param patch_columns [Turbopuffer::Models::Columns] A list of documents in columnar format. Each key is a column name, mapped to an
       #
       #   @param patch_condition [Object] A condition evaluated against the current value of each document targeted by a p
@@ -153,6 +169,26 @@ module Turbopuffer
           #   @param key_name [String] The identifier of the CMEK key to use for encryption. For GCP, the fully-qualifi
         end
       end
+
+      class PatchByFilter < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute filters
+        #   Filter by attributes. Same syntax as the query endpoint.
+        #
+        #   @return [Object]
+        required :filters, Turbopuffer::Internal::Type::Unknown
+
+        # @!attribute patch
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :patch, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
+
+        # @!method initialize(filters:, patch:)
+        #   The patch and filter specifying which documents to patch.
+        #
+        #   @param filters [Object] Filter by attributes. Same syntax as the query endpoint.
+        #
+        #   @param patch [Hash{Symbol=>Object}]
+      end
     end
   end
 end

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_by_filter: 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,10 +317,14 @@ 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.
       #
+      # @param patch_by_filter [Turbopuffer::Models::NamespaceWriteParams::PatchByFilter] Body param: The patch and filter specifying which documents to patch.
+      #
       # @param patch_columns [Turbopuffer::Models::Columns] Body param: A list of documents in columnar format. Each key is a column name, m
       #
       # @param patch_condition [Object] Body param: A condition evaluated against the current value of each document tar

data/lib/turbopuffer/version.rb

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

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/namespace_metadata.rbi

@@ -24,13 +24,62 @@ module Turbopuffer
       sig { returns(T::Hash[Symbol, Turbopuffer::AttributeSchemaConfig]) }
       attr_accessor :schema
 
+      # The timestamp when the namespace was last modified by a write operation.
+      sig { returns(Time) }
+      attr_accessor :updated_at
+
+      # Indicates that the namespace is encrypted with a customer-managed encryption key
+      # (CMEK).
+      sig do
+        returns(T.nilable(Turbopuffer::NamespaceMetadata::Encryption::Variants))
+      end
+      attr_reader :encryption
+
+      sig do
+        params(
+          encryption:
+            T.any(
+              T::Boolean,
+              Turbopuffer::NamespaceMetadata::Encryption::Cmek::OrHash
+            )
+        ).void
+      end
+      attr_writer :encryption
+
+      sig do
+        returns(T.nilable(Turbopuffer::NamespaceMetadata::Index::Variants))
+      end
+      attr_reader :index
+
+      sig do
+        params(
+          index:
+            T.any(
+              Turbopuffer::NamespaceMetadata::Index::Status::OrHash,
+              Turbopuffer::NamespaceMetadata::Index::UnionMember1::OrHash
+            )
+        ).void
+      end
+      attr_writer :index
+
       # Metadata about a namespace.
       sig do
         params(
           approx_logical_bytes: Integer,
           approx_row_count: Integer,
           created_at: Time,
-          schema: T::Hash[Symbol, Turbopuffer::AttributeSchemaConfig::OrHash]
+          schema: T::Hash[Symbol, Turbopuffer::AttributeSchemaConfig::OrHash],
+          updated_at: Time,
+          encryption:
+            T.any(
+              T::Boolean,
+              Turbopuffer::NamespaceMetadata::Encryption::Cmek::OrHash
+            ),
+          index:
+            T.any(
+              Turbopuffer::NamespaceMetadata::Index::Status::OrHash,
+              Turbopuffer::NamespaceMetadata::Index::UnionMember1::OrHash
+            )
         ).returns(T.attached_class)
       end
       def self.new(
@@ -41,7 +90,13 @@ module Turbopuffer
         # The timestamp when the namespace was created.
         created_at:,
         # The schema of the namespace.
-        schema:
+        schema:,
+        # The timestamp when the namespace was last modified by a write operation.
+        updated_at:,
+        # Indicates that the namespace is encrypted with a customer-managed encryption key
+        # (CMEK).
+        encryption: nil,
+        index: nil
       )
       end
 
@@ -51,12 +106,179 @@ module Turbopuffer
             approx_logical_bytes: Integer,
             approx_row_count: Integer,
             created_at: Time,
-            schema: T::Hash[Symbol, Turbopuffer::AttributeSchemaConfig]
+            schema: T::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
+            updated_at: Time,
+            encryption: Turbopuffer::NamespaceMetadata::Encryption::Variants,
+            index: Turbopuffer::NamespaceMetadata::Index::Variants
           }
         )
       end
       def to_hash
       end
+
+      # Indicates that the namespace is encrypted with a customer-managed encryption key
+      # (CMEK).
+      module Encryption
+        extend Turbopuffer::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(T::Boolean, Turbopuffer::NamespaceMetadata::Encryption::Cmek)
+          end
+
+        class Cmek < Turbopuffer::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Turbopuffer::NamespaceMetadata::Encryption::Cmek,
+                Turbopuffer::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              T.nilable(Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek)
+            )
+          end
+          attr_reader :cmek
+
+          sig do
+            params(
+              cmek:
+                Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek::OrHash
+            ).void
+          end
+          attr_writer :cmek
+
+          # Indicates that the namespace is encrypted with a customer-managed encryption key
+          # (CMEK).
+          sig do
+            params(
+              cmek:
+                Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(cmek: nil)
+          end
+
+          sig do
+            override.returns(
+              { cmek: Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek }
+            )
+          end
+          def to_hash
+          end
+
+          class Cmek < Turbopuffer::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek,
+                  Turbopuffer::Internal::AnyHash
+                )
+              end
+
+            # The name of the CMEK key in use.
+            sig { returns(String) }
+            attr_accessor :key_name
+
+            sig { params(key_name: String).returns(T.attached_class) }
+            def self.new(
+              # The name of the CMEK key in use.
+              key_name:
+            )
+            end
+
+            sig { override.returns({ key_name: String }) }
+            def to_hash
+            end
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[Turbopuffer::NamespaceMetadata::Encryption::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+
+      module Index
+        extend Turbopuffer::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Turbopuffer::NamespaceMetadata::Index::Status,
+              Turbopuffer::NamespaceMetadata::Index::UnionMember1
+            )
+          end
+
+        class Status < Turbopuffer::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Turbopuffer::NamespaceMetadata::Index::Status,
+                Turbopuffer::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Symbol) }
+          attr_accessor :status
+
+          sig { params(status: Symbol).returns(T.attached_class) }
+          def self.new(status: :"up-to-date")
+          end
+
+          sig { override.returns({ status: Symbol }) }
+          def to_hash
+          end
+        end
+
+        class UnionMember1 < Turbopuffer::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Turbopuffer::NamespaceMetadata::Index::UnionMember1,
+                Turbopuffer::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Symbol) }
+          attr_accessor :status
+
+          # The number of bytes in the namespace that are in the write-ahead log but have
+          # not yet been indexed.
+          sig { returns(Integer) }
+          attr_accessor :unindexed_bytes
+
+          sig do
+            params(unindexed_bytes: Integer, status: Symbol).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # The number of bytes in the namespace that are in the write-ahead log but have
+            # not yet been indexed.
+            unindexed_bytes:,
+            status: :updating
+          )
+          end
+
+          sig { override.returns({ status: Symbol, unindexed_bytes: Integer }) }
+          def to_hash
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[Turbopuffer::NamespaceMetadata::Index::Variants]
+          )
+        end
+        def self.variants
+        end
+      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
@@ -68,6 +75,20 @@ module Turbopuffer
       end
       attr_writer :encryption
 
+      # The patch and filter specifying which documents to patch.
+      sig do
+        returns(T.nilable(Turbopuffer::NamespaceWriteParams::PatchByFilter))
+      end
+      attr_reader :patch_by_filter
+
+      sig do
+        params(
+          patch_by_filter:
+            Turbopuffer::NamespaceWriteParams::PatchByFilter::OrHash
+        ).void
+      end
+      attr_writer :patch_by_filter
+
       # A list of documents in columnar format. Each key is a column name, mapped to an
       # array of values for that column.
       sig { returns(T.nilable(Turbopuffer::Columns)) }
@@ -140,8 +161,11 @@ 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_by_filter:
+            Turbopuffer::NamespaceWriteParams::PatchByFilter::OrHash,
           patch_columns: Turbopuffer::Columns::OrHash,
           patch_condition: T.anything,
           patch_rows: T::Array[Turbopuffer::Row::OrHash],
@@ -166,10 +190,14 @@ 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.
         encryption: nil,
+        # The patch and filter specifying which documents to patch.
+        patch_by_filter: nil,
         # A list of documents in columnar format. Each key is a column name, mapped to an
         # array of values for that column.
         patch_columns: nil,
@@ -198,8 +226,10 @@ 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_by_filter: Turbopuffer::NamespaceWriteParams::PatchByFilter,
             patch_columns: Turbopuffer::Columns,
             patch_condition: T.anything,
             patch_rows: T::Array[Turbopuffer::Row],
@@ -285,6 +315,45 @@ module Turbopuffer
           end
         end
       end
+
+      class PatchByFilter < Turbopuffer::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Turbopuffer::NamespaceWriteParams::PatchByFilter,
+              Turbopuffer::Internal::AnyHash
+            )
+          end
+
+        # Filter by attributes. Same syntax as the query endpoint.
+        sig { returns(T.anything) }
+        attr_accessor :filters
+
+        sig { returns(T::Hash[Symbol, T.anything]) }
+        attr_accessor :patch
+
+        # The patch and filter specifying which documents to patch.
+        sig do
+          params(
+            filters: T.anything,
+            patch: T::Hash[Symbol, T.anything]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Filter by attributes. Same syntax as the query endpoint.
+          filters:,
+          patch:
+        )
+        end
+
+        sig do
+          override.returns(
+            { filters: T.anything, patch: T::Hash[Symbol, T.anything] }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

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,8 +240,11 @@ 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_by_filter:
+            Turbopuffer::NamespaceWriteParams::PatchByFilter::OrHash,
           patch_columns: Turbopuffer::Columns::OrHash,
           patch_condition: T.anything,
           patch_rows: T::Array[Turbopuffer::Row::OrHash],
@@ -268,10 +271,15 @@ 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.
         encryption: nil,
+        # Body param: The patch and filter specifying which documents to patch.
+        patch_by_filter: nil,
         # Body param: A list of documents in columnar format. Each key is a column name,
         # mapped to an array of values for that column.
         patch_columns: nil,

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/namespace_metadata.rbs

@@ -5,7 +5,10 @@ module Turbopuffer
         approx_logical_bytes: Integer,
         approx_row_count: Integer,
         created_at: Time,
-        schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig]
+        schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
+        updated_at: Time,
+        encryption: Turbopuffer::Models::NamespaceMetadata::encryption,
+        index: Turbopuffer::Models::NamespaceMetadata::index
       }
 
     class NamespaceMetadata < Turbopuffer::Internal::Type::BaseModel
@@ -17,19 +20,108 @@ module Turbopuffer
 
       attr_accessor schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig]
 
+      attr_accessor updated_at: Time
+
+      attr_reader encryption: Turbopuffer::Models::NamespaceMetadata::encryption?
+
+      def encryption=: (
+        Turbopuffer::Models::NamespaceMetadata::encryption
+      ) -> Turbopuffer::Models::NamespaceMetadata::encryption
+
+      attr_reader index: Turbopuffer::Models::NamespaceMetadata::index?
+
+      def index=: (
+        Turbopuffer::Models::NamespaceMetadata::index
+      ) -> Turbopuffer::Models::NamespaceMetadata::index
+
       def initialize: (
         approx_logical_bytes: Integer,
         approx_row_count: Integer,
         created_at: Time,
-        schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig]
+        schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
+        updated_at: Time,
+        ?encryption: Turbopuffer::Models::NamespaceMetadata::encryption,
+        ?index: Turbopuffer::Models::NamespaceMetadata::index
       ) -> void
 
       def to_hash: -> {
         approx_logical_bytes: Integer,
         approx_row_count: Integer,
         created_at: Time,
-        schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig]
+        schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
+        updated_at: Time,
+        encryption: Turbopuffer::Models::NamespaceMetadata::encryption,
+        index: Turbopuffer::Models::NamespaceMetadata::index
       }
+
+      type encryption = bool | Turbopuffer::NamespaceMetadata::Encryption::Cmek
+
+      module Encryption
+        extend Turbopuffer::Internal::Type::Union
+
+        type cmek =
+          { cmek: Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek }
+
+        class Cmek < Turbopuffer::Internal::Type::BaseModel
+          attr_reader cmek: Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek?
+
+          def cmek=: (
+            Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek
+          ) -> Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek
+
+          def initialize: (
+            ?cmek: Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek
+          ) -> void
+
+          def to_hash: -> {
+            cmek: Turbopuffer::NamespaceMetadata::Encryption::Cmek::Cmek
+          }
+
+          type cmek = { key_name: String }
+
+          class Cmek < Turbopuffer::Internal::Type::BaseModel
+            attr_accessor key_name: String
+
+            def initialize: (key_name: String) -> void
+
+            def to_hash: -> { key_name: String }
+          end
+        end
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceMetadata::encryption]
+      end
+
+      type index =
+        Turbopuffer::NamespaceMetadata::Index::Status
+        | Turbopuffer::NamespaceMetadata::Index::UnionMember1
+
+      module Index
+        extend Turbopuffer::Internal::Type::Union
+
+        type status = { status: :"up-to-date" }
+
+        class Status < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor status: :"up-to-date"
+
+          def initialize: (?status: :"up-to-date") -> void
+
+          def to_hash: -> { status: :"up-to-date" }
+        end
+
+        type union_member1 = { status: :updating, unindexed_bytes: Integer }
+
+        class UnionMember1 < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor status: :updating
+
+          attr_accessor unindexed_bytes: Integer
+
+          def initialize: (unindexed_bytes: Integer, ?status: :updating) -> void
+
+          def to_hash: -> { status: :updating, unindexed_bytes: Integer }
+        end
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceMetadata::index]
+      end
     end
   end
 end

data/sig/turbopuffer/models/namespace_write_params.rbs

@@ -7,8 +7,10 @@ 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_by_filter: Turbopuffer::NamespaceWriteParams::PatchByFilter,
         patch_columns: Turbopuffer::Columns,
         patch_condition: top,
         patch_rows: ::Array[Turbopuffer::Row],
@@ -45,6 +47,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=: (
@@ -57,6 +63,12 @@ module Turbopuffer
         Turbopuffer::NamespaceWriteParams::Encryption
       ) -> Turbopuffer::NamespaceWriteParams::Encryption
 
+      attr_reader patch_by_filter: Turbopuffer::NamespaceWriteParams::PatchByFilter?
+
+      def patch_by_filter=: (
+        Turbopuffer::NamespaceWriteParams::PatchByFilter
+      ) -> Turbopuffer::NamespaceWriteParams::PatchByFilter
+
       attr_reader patch_columns: Turbopuffer::Columns?
 
       def patch_columns=: (Turbopuffer::Columns) -> Turbopuffer::Columns
@@ -93,8 +105,10 @@ 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_by_filter: Turbopuffer::NamespaceWriteParams::PatchByFilter,
         ?patch_columns: Turbopuffer::Columns,
         ?patch_condition: top,
         ?patch_rows: ::Array[Turbopuffer::Row],
@@ -111,8 +125,10 @@ 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_by_filter: Turbopuffer::NamespaceWriteParams::PatchByFilter,
         patch_columns: Turbopuffer::Columns,
         patch_condition: top,
         patch_rows: ::Array[Turbopuffer::Row],
@@ -151,6 +167,18 @@ module Turbopuffer
           def to_hash: -> { key_name: String }
         end
       end
+
+      type patch_by_filter = { filters: top, patch: ::Hash[Symbol, top] }
+
+      class PatchByFilter < Turbopuffer::Internal::Type::BaseModel
+        attr_accessor filters: top
+
+        attr_accessor patch: ::Hash[Symbol, top]
+
+        def initialize: (filters: top, patch: ::Hash[Symbol, top]) -> void
+
+        def to_hash: -> { filters: top, patch: ::Hash[Symbol, top] }
+      end
     end
   end
 end

data/sig/turbopuffer/resources/namespaces.rbs

@@ -81,8 +81,10 @@ 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_by_filter: Turbopuffer::NamespaceWriteParams::PatchByFilter,
         ?patch_columns: Turbopuffer::Columns,
         ?patch_condition: top,
         ?patch_rows: ::Array[Turbopuffer::Row],

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-19 00:00:00.000000000 Z
+date: 2025-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool