turbopuffer 2.9.0 → 2.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +22 -0
  3. data/README.md +10 -2
  4. data/lib/turbopuffer/client.rb +10 -1
  5. data/lib/turbopuffer/internal/telemetry.rb +86 -10
  6. data/lib/turbopuffer/internal/transport/base_client.rb +12 -1
  7. data/lib/turbopuffer/models/encryption.rb +11 -1
  8. data/lib/turbopuffer/models/namespace_explain_query_params.rb +50 -24
  9. data/lib/turbopuffer/models/namespace_multi_query_params.rb +50 -24
  10. data/lib/turbopuffer/models/namespace_query_params.rb +50 -24
  11. data/lib/turbopuffer/resources/namespaces.rb +3 -3
  12. data/lib/turbopuffer/version.rb +1 -1
  13. data/lib/turbopuffer.rb +0 -1
  14. data/manifest.yaml +0 -1
  15. data/rbi/turbopuffer/client.rbi +9 -2
  16. data/rbi/turbopuffer/internal/telemetry.rbi +43 -3
  17. data/rbi/turbopuffer/internal/transport/base_client.rbi +5 -0
  18. data/rbi/turbopuffer/models/encryption.rbi +29 -2
  19. data/rbi/turbopuffer/models/namespace_explain_query_params.rbi +84 -71
  20. data/rbi/turbopuffer/models/namespace_multi_query_params.rbi +86 -71
  21. data/rbi/turbopuffer/models/namespace_query_params.rbi +88 -71
  22. data/rbi/turbopuffer/resources/namespaces.rbi +13 -3
  23. data/sig/turbopuffer/client.rbs +4 -1
  24. data/sig/turbopuffer/internal/telemetry.rbs +14 -1
  25. data/sig/turbopuffer/internal/transport/base_client.rbs +3 -0
  26. data/sig/turbopuffer/models/encryption.rbs +22 -3
  27. data/sig/turbopuffer/models/namespace_explain_query_params.rbs +30 -28
  28. data/sig/turbopuffer/models/namespace_multi_query_params.rbs +30 -28
  29. data/sig/turbopuffer/models/namespace_query_params.rbs +30 -26
  30. data/sig/turbopuffer/resources/namespaces.rbs +3 -3
  31. metadata +3 -3
@@ -5,7 +5,7 @@ module Turbopuffer
5
5
  namespace: String,
6
6
  aggregate_by: ::Hash[Symbol, top],
7
7
  compute_attributes: ::Hash[Symbol, top],
8
- consistency: Turbopuffer::NamespaceQueryParams::Consistency,
8
+ consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
9
9
  distance_metric: Turbopuffer::Models::distance_metric,
10
10
  exclude_attributes: ::Array[String],
11
11
  filters: top,
@@ -36,11 +36,11 @@ module Turbopuffer
36
36
 
37
37
  def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
38
38
 
39
- attr_reader consistency: Turbopuffer::NamespaceQueryParams::Consistency?
39
+ attr_reader consistency: Turbopuffer::Models::NamespaceQueryParams::consistency?
40
40
 
41
41
  def consistency=: (
42
- Turbopuffer::NamespaceQueryParams::Consistency
43
- ) -> Turbopuffer::NamespaceQueryParams::Consistency
42
+ Turbopuffer::Models::NamespaceQueryParams::consistency
43
+ ) -> Turbopuffer::Models::NamespaceQueryParams::consistency
44
44
 
45
45
  attr_reader distance_metric: Turbopuffer::Models::distance_metric?
46
46
 
@@ -100,7 +100,7 @@ module Turbopuffer
100
100
  ?namespace: String,
101
101
  ?aggregate_by: ::Hash[Symbol, top],
102
102
  ?compute_attributes: ::Hash[Symbol, top],
103
- ?consistency: Turbopuffer::NamespaceQueryParams::Consistency,
103
+ ?consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
104
104
  ?distance_metric: Turbopuffer::Models::distance_metric,
105
105
  ?exclude_attributes: ::Array[String],
106
106
  ?filters: top,
@@ -119,7 +119,7 @@ module Turbopuffer
119
119
  namespace: String,
120
120
  aggregate_by: ::Hash[Symbol, top],
121
121
  compute_attributes: ::Hash[Symbol, top],
122
- consistency: Turbopuffer::NamespaceQueryParams::Consistency,
122
+ consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
123
123
  distance_metric: Turbopuffer::Models::distance_metric,
124
124
  exclude_attributes: ::Array[String],
125
125
  filters: top,
@@ -135,36 +135,40 @@ module Turbopuffer
135
135
  }
136
136
 
137
137
  type consistency =
138
- { level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level }
138
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong
139
+ | Turbopuffer::NamespaceQueryParams::Consistency::Eventual
139
140
 
140
- class Consistency < Turbopuffer::Internal::Type::BaseModel
141
- attr_reader level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level?
141
+ module Consistency
142
+ extend Turbopuffer::Internal::Type::Union
143
+
144
+ type strong = { level: :strong }
142
145
 
143
- def level=: (
144
- Turbopuffer::Models::NamespaceQueryParams::Consistency::level
145
- ) -> Turbopuffer::Models::NamespaceQueryParams::Consistency::level
146
+ class Strong < Turbopuffer::Internal::Type::BaseModel
147
+ attr_accessor level: :strong
146
148
 
147
- def initialize: (
148
- ?level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level
149
- ) -> void
149
+ def initialize: (?level: :strong) -> void
150
150
 
151
- def to_hash: -> {
152
- level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level
153
- }
151
+ def to_hash: -> { level: :strong }
152
+ end
154
153
 
155
- type level = :strong | :eventual
154
+ type eventual = { level: :eventual, max_staleness_seconds: Integer }
156
155
 
157
- module Level
158
- extend Turbopuffer::Internal::Type::Enum
156
+ class Eventual < Turbopuffer::Internal::Type::BaseModel
157
+ attr_accessor level: :eventual
159
158
 
160
- # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
161
- STRONG: :strong
159
+ attr_reader max_staleness_seconds: Integer?
162
160
 
163
- # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
164
- EVENTUAL: :eventual
161
+ def max_staleness_seconds=: (Integer) -> Integer
165
162
 
166
- def self?.values: -> ::Array[Turbopuffer::Models::NamespaceQueryParams::Consistency::level]
163
+ def initialize: (
164
+ ?max_staleness_seconds: Integer,
165
+ ?level: :eventual
166
+ ) -> void
167
+
168
+ def to_hash: -> { level: :eventual, max_staleness_seconds: Integer }
167
169
  end
170
+
171
+ def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceQueryParams::consistency]
168
172
  end
169
173
 
170
174
  type limit = Integer | Turbopuffer::Limit
@@ -25,7 +25,7 @@ module Turbopuffer
25
25
  ?namespace: String,
26
26
  ?aggregate_by: ::Hash[Symbol, top],
27
27
  ?compute_attributes: ::Hash[Symbol, top],
28
- ?consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
28
+ ?consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
29
29
  ?distance_metric: Turbopuffer::Models::distance_metric,
30
30
  ?exclude_attributes: ::Array[String],
31
31
  ?filters: top,
@@ -52,7 +52,7 @@ module Turbopuffer
52
52
  def multi_query: (
53
53
  queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
54
54
  ?namespace: String,
55
- ?consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
55
+ ?consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
56
56
  ?limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
57
57
  ?offset: Integer,
58
58
  ?rerank_by: top,
@@ -70,7 +70,7 @@ module Turbopuffer
70
70
  ?namespace: String,
71
71
  ?aggregate_by: ::Hash[Symbol, top],
72
72
  ?compute_attributes: ::Hash[Symbol, top],
73
- ?consistency: Turbopuffer::NamespaceQueryParams::Consistency,
73
+ ?consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
74
74
  ?distance_metric: Turbopuffer::Models::distance_metric,
75
75
  ?exclude_attributes: ::Array[String],
76
76
  ?filters: top,
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: turbopuffer
3
3
  version: !ruby/object:Gem::Version
4
- version: 2.9.0
4
+ version: 2.11.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Turbopuffer
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-10-22 00:00:00.000000000 Z
11
+ date: 2026-10-29 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: cgi
@@ -385,7 +385,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
385
385
  - !ruby/object:Gem::Version
386
386
  version: '0'
387
387
  requirements: []
388
- rubygems_version: 3.4.1
388
+ rubygems_version: 3.4.19
389
389
  signing_key:
390
390
  specification_version: 4
391
391
  summary: Ruby library to access the Turbopuffer API