turbopuffer 2.0.0.pre.alpha.1 → 2.0.0.pre.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fde3b29deac3a828174a6a5f6255d81bde5182f8c4b4cb83f702e16c69a2c6c
-  data.tar.gz: 90aabb5c4ce6118046e6a93063f0ead79498511fc1a61f0d61f1da0b961ac51d
+  metadata.gz: ec352d339fe92ac66fb6632df2bed51b81559d640f3b4a2140e1ded77218f282
+  data.tar.gz: ce362c309ffab91afb01bf3d057f66200b166cc8087bc7055d95f26492cfb941
 SHA512:
-  metadata.gz: a3c9579b604aee56e05f0617558f582c41591c7570d577a739404916c07dc4aaf5c77988823c3d630720157aaa262ac50d6ae20e4c4a906b2582293688196b81
-  data.tar.gz: a7da8ab2ba206e0282f8db9b7d55a096d3248db24456ec3674c87b64f8db8222a869a42b346a329eaab390ecfdfcdb90f45648f7ef076af6409b7779b42a9735
+  metadata.gz: '0854bb51b122e2db1f0df2c44e2625e6486c964489615e730b97dd6a541cdb1dff537c41b3e93b967fc5b04a501068cab9342e787a8d186051d0b5a91096588a'
+  data.tar.gz: 00514217b637eb9f7d8a6dab848489334267aa8ff5b1ae1c3956fb3e1779cab7c6da22db534e57eb349dee4d9f176e872eae52780a90a234b7342bb01b13e52b

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.0.0-alpha.2 (2026-04-29)
+
+Full Changelog: [v2.0.0-alpha.1...v2.0.0-alpha.2](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.0.0-alpha.1...v2.0.0-alpha.2)
+
+### Features
+
+* Spec: Add sparse_distance_metric to the list of models. ([81f2998](https://github.com/turbopuffer/turbopuffer-ruby/commit/81f29982fb72e5f90923a35975841633b40aacc5))
+
 ## 2.0.0-alpha.1 (2026-04-29)
 
 Full Changelog: [v1.19.0...v2.0.0-alpha.1](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.19.0...v2.0.0-alpha.1)

data/README.md

@@ -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.0.0.pre.alpha.1"
+gem "turbopuffer", "~> 2.0.0.pre.alpha.2"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/models/attribute_schema_config.rb

@@ -113,14 +113,14 @@ module Turbopuffer
         # @!attribute distance_metric
         #   A function used to calculate sparse vector similarity.
         #
-        #   @return [Symbol, :dot_product]
-        required :distance_metric, const: :dot_product
+        #   @return [Symbol, Turbopuffer::Models::SparseDistanceMetric]
+        required :distance_metric, enum: -> { Turbopuffer::SparseDistanceMetric }
 
-        # @!method initialize(distance_metric: :dot_product)
+        # @!method initialize(distance_metric:)
         #   Whether to create a sparse kNN index for the attribute. Requires the `{}f16`
         #   type.
         #
-        #   @param distance_metric [Symbol, :dot_product] A function used to calculate sparse vector similarity.
+        #   @param distance_metric [Symbol, Turbopuffer::Models::SparseDistanceMetric] A function used to calculate sparse vector similarity.
       end
     end
   end

data/lib/turbopuffer/models/sparse_distance_metric.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # A function used to calculate sparse vector similarity.
+    module SparseDistanceMetric
+      extend Turbopuffer::Internal::Type::Enum
+
+      DOT_PRODUCT = :dot_product
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/turbopuffer/models.rb

@@ -122,6 +122,8 @@ module Turbopuffer
 
   SaturateParams = Turbopuffer::Models::SaturateParams
 
+  SparseDistanceMetric = Turbopuffer::Models::SparseDistanceMetric
+
   Tokenizer = Turbopuffer::Models::Tokenizer
 
   Vector = Turbopuffer::Models::Vector

data/lib/turbopuffer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Turbopuffer
-  VERSION = "2.0.0.pre.alpha.1"
+  VERSION = "2.0.0.pre.alpha.2"
 end

data/lib/turbopuffer.rb

@@ -105,6 +105,7 @@ require_relative "turbopuffer/models/query_billing"
 require_relative "turbopuffer/models/query_performance"
 require_relative "turbopuffer/models/row"
 require_relative "turbopuffer/models/saturate_params"
+require_relative "turbopuffer/models/sparse_distance_metric"
 require_relative "turbopuffer/models/tokenizer"
 require_relative "turbopuffer/models/vector"
 require_relative "turbopuffer/models/vector_encoding"

data/rbi/turbopuffer/models/attribute_schema_config.rbi

@@ -235,19 +235,27 @@ module Turbopuffer
           end
 
         # A function used to calculate sparse vector similarity.
-        sig { returns(Symbol) }
+        sig { returns(Turbopuffer::SparseDistanceMetric::OrSymbol) }
         attr_accessor :distance_metric
 
         # Whether to create a sparse kNN index for the attribute. Requires the `{}f16`
         # type.
-        sig { params(distance_metric: Symbol).returns(T.attached_class) }
+        sig do
+          params(
+            distance_metric: Turbopuffer::SparseDistanceMetric::OrSymbol
+          ).returns(T.attached_class)
+        end
         def self.new(
           # A function used to calculate sparse vector similarity.
-          distance_metric: :dot_product
+          distance_metric:
         )
         end
 
-        sig { override.returns({ distance_metric: Symbol }) }
+        sig do
+          override.returns(
+            { distance_metric: Turbopuffer::SparseDistanceMetric::OrSymbol }
+          )
+        end
         def to_hash
         end
       end

data/rbi/turbopuffer/models/sparse_distance_metric.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    # A function used to calculate sparse vector similarity.
+    module SparseDistanceMetric
+      extend Turbopuffer::Internal::Type::Enum
+
+      TaggedSymbol =
+        T.type_alias { T.all(Symbol, Turbopuffer::SparseDistanceMetric) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      DOT_PRODUCT =
+        T.let(:dot_product, Turbopuffer::SparseDistanceMetric::TaggedSymbol)
+
+      sig do
+        override.returns(
+          T::Array[Turbopuffer::SparseDistanceMetric::TaggedSymbol]
+        )
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models.rbi

@@ -91,6 +91,8 @@ module Turbopuffer
 
   SaturateParams = Turbopuffer::Models::SaturateParams
 
+  SparseDistanceMetric = Turbopuffer::Models::SparseDistanceMetric
+
   Tokenizer = Turbopuffer::Models::Tokenizer
 
   Vector = Turbopuffer::Models::Vector

data/sig/turbopuffer/models/attribute_schema_config.rbs

@@ -98,14 +98,19 @@ module Turbopuffer
         def self?.variants: -> ::Array[Turbopuffer::Models::AttributeSchemaConfig::ann]
       end
 
-      type sparse_knn = { distance_metric: :dot_product }
+      type sparse_knn =
+        { distance_metric: Turbopuffer::Models::sparse_distance_metric }
 
       class SparseKnn < Turbopuffer::Internal::Type::BaseModel
-        attr_accessor distance_metric: :dot_product
+        attr_accessor distance_metric: Turbopuffer::Models::sparse_distance_metric
 
-        def initialize: (?distance_metric: :dot_product) -> void
+        def initialize: (
+          distance_metric: Turbopuffer::Models::sparse_distance_metric
+        ) -> void
 
-        def to_hash: -> { distance_metric: :dot_product }
+        def to_hash: -> {
+          distance_metric: Turbopuffer::Models::sparse_distance_metric
+        }
       end
     end
   end

data/sig/turbopuffer/models/sparse_distance_metric.rbs

@@ -0,0 +1,13 @@
+module Turbopuffer
+  module Models
+    type sparse_distance_metric = :dot_product
+
+    module SparseDistanceMetric
+      extend Turbopuffer::Internal::Type::Enum
+
+      DOT_PRODUCT: :dot_product
+
+      def self?.values: -> ::Array[Turbopuffer::Models::sparse_distance_metric]
+    end
+  end
+end

data/sig/turbopuffer/models.rbs

@@ -81,6 +81,8 @@ module Turbopuffer
 
   class SaturateParams = Turbopuffer::Models::SaturateParams
 
+  module SparseDistanceMetric = Turbopuffer::Models::SparseDistanceMetric
+
   module Tokenizer = Turbopuffer::Models::Tokenizer
 
   module Vector = Turbopuffer::Models::Vector

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.1
+  version: 2.0.0.pre.alpha.2
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -122,6 +122,7 @@ files:
 - lib/turbopuffer/models/query_performance.rb
 - lib/turbopuffer/models/row.rb
 - lib/turbopuffer/models/saturate_params.rb
+- lib/turbopuffer/models/sparse_distance_metric.rb
 - lib/turbopuffer/models/tokenizer.rb
 - lib/turbopuffer/models/vector.rb
 - lib/turbopuffer/models/vector_encoding.rb
@@ -204,6 +205,7 @@ files:
 - rbi/turbopuffer/models/query_performance.rbi
 - rbi/turbopuffer/models/row.rbi
 - rbi/turbopuffer/models/saturate_params.rbi
+- rbi/turbopuffer/models/sparse_distance_metric.rbi
 - rbi/turbopuffer/models/tokenizer.rbi
 - rbi/turbopuffer/models/vector.rbi
 - rbi/turbopuffer/models/vector_encoding.rbi
@@ -285,6 +287,7 @@ files:
 - sig/turbopuffer/models/query_performance.rbs
 - sig/turbopuffer/models/row.rbs
 - sig/turbopuffer/models/saturate_params.rbs
+- sig/turbopuffer/models/sparse_distance_metric.rbs
 - sig/turbopuffer/models/tokenizer.rbs
 - sig/turbopuffer/models/vector.rbs
 - sig/turbopuffer/models/vector_encoding.rbs