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
@@ -38,12 +38,25 @@ module Turbopuffer
38
38
  attr_writer :compute_attributes
39
39
 
40
40
  # The consistency level for a query.
41
- sig { returns(T.nilable(Turbopuffer::NamespaceQueryParams::Consistency)) }
41
+ sig do
42
+ returns(
43
+ T.nilable(
44
+ T.any(
45
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong,
46
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual
47
+ )
48
+ )
49
+ )
50
+ end
42
51
  attr_reader :consistency
43
52
 
44
53
  sig do
45
54
  params(
46
- consistency: Turbopuffer::NamespaceQueryParams::Consistency::OrHash
55
+ consistency:
56
+ T.any(
57
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong::OrHash,
58
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual::OrHash
59
+ )
47
60
  ).void
48
61
  end
49
62
  attr_writer :consistency
@@ -142,7 +155,11 @@ module Turbopuffer
142
155
  namespace: String,
143
156
  aggregate_by: T::Hash[Symbol, T.anything],
144
157
  compute_attributes: T::Hash[Symbol, T.anything],
145
- consistency: Turbopuffer::NamespaceQueryParams::Consistency::OrHash,
158
+ consistency:
159
+ T.any(
160
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong::OrHash,
161
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual::OrHash
162
+ ),
146
163
  distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
147
164
  exclude_attributes: T::Array[String],
148
165
  filters: T.anything,
@@ -204,7 +221,11 @@ module Turbopuffer
204
221
  namespace: String,
205
222
  aggregate_by: T::Hash[Symbol, T.anything],
206
223
  compute_attributes: T::Hash[Symbol, T.anything],
207
- consistency: Turbopuffer::NamespaceQueryParams::Consistency,
224
+ consistency:
225
+ T.any(
226
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong,
227
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual
228
+ ),
208
229
  distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
209
230
  exclude_attributes: T::Array[String],
210
231
  filters: T.anything,
@@ -223,94 +244,90 @@ module Turbopuffer
223
244
  def to_hash
224
245
  end
225
246
 
226
- class Consistency < Turbopuffer::Internal::Type::BaseModel
227
- OrHash =
247
+ # The consistency level for a query.
248
+ module Consistency
249
+ extend Turbopuffer::Internal::Type::Union
250
+
251
+ Variants =
228
252
  T.type_alias do
229
253
  T.any(
230
- Turbopuffer::NamespaceQueryParams::Consistency,
231
- Turbopuffer::Internal::AnyHash
254
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong,
255
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual
232
256
  )
233
257
  end
234
258
 
235
- # The query's consistency level.
236
- sig do
237
- returns(
238
- T.nilable(
239
- Turbopuffer::NamespaceQueryParams::Consistency::Level::OrSymbol
240
- )
241
- )
242
- end
243
- attr_reader :level
259
+ class Strong < Turbopuffer::Internal::Type::BaseModel
260
+ OrHash =
261
+ T.type_alias do
262
+ T.any(
263
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong,
264
+ Turbopuffer::Internal::AnyHash
265
+ )
266
+ end
244
267
 
245
- sig do
246
- params(
247
- level:
248
- Turbopuffer::NamespaceQueryParams::Consistency::Level::OrSymbol
249
- ).void
250
- end
251
- attr_writer :level
268
+ sig { returns(Symbol) }
269
+ attr_accessor :level
252
270
 
253
- # The consistency level for a query.
254
- sig do
255
- params(
256
- level:
257
- Turbopuffer::NamespaceQueryParams::Consistency::Level::OrSymbol
258
- ).returns(T.attached_class)
259
- end
260
- def self.new(
261
- # The query's consistency level.
262
- level: nil
263
- )
264
- end
271
+ # Strong consistency. Requires a round-trip to object storage to fetch the latest
272
+ # writes.
273
+ sig { params(level: Symbol).returns(T.attached_class) }
274
+ def self.new(level: :strong)
275
+ end
265
276
 
266
- sig do
267
- override.returns(
268
- {
269
- level:
270
- Turbopuffer::NamespaceQueryParams::Consistency::Level::OrSymbol
271
- }
272
- )
273
- end
274
- def to_hash
277
+ sig { override.returns({ level: Symbol }) }
278
+ def to_hash
279
+ end
275
280
  end
276
281
 
277
- # The query's consistency level.
278
- module Level
279
- extend Turbopuffer::Internal::Type::Enum
280
-
281
- TaggedSymbol =
282
+ class Eventual < Turbopuffer::Internal::Type::BaseModel
283
+ OrHash =
282
284
  T.type_alias do
283
- T.all(
284
- Symbol,
285
- Turbopuffer::NamespaceQueryParams::Consistency::Level
285
+ T.any(
286
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual,
287
+ Turbopuffer::Internal::AnyHash
286
288
  )
287
289
  end
288
- OrSymbol = T.type_alias { T.any(Symbol, String) }
289
290
 
290
- # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
291
- STRONG =
292
- T.let(
293
- :strong,
294
- Turbopuffer::NamespaceQueryParams::Consistency::Level::TaggedSymbol
295
- )
291
+ sig { returns(Symbol) }
292
+ attr_accessor :level
296
293
 
297
- # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
298
- EVENTUAL =
299
- T.let(
300
- :eventual,
301
- Turbopuffer::NamespaceQueryParams::Consistency::Level::TaggedSymbol
302
- )
294
+ # How long the query may reuse the node's cached view of the namespace before
295
+ # refreshing it from object storage. Defaults to 60.
296
+ sig { returns(T.nilable(Integer)) }
297
+ attr_reader :max_staleness_seconds
298
+
299
+ sig { params(max_staleness_seconds: Integer).void }
300
+ attr_writer :max_staleness_seconds
303
301
 
302
+ # Eventual consistency. Does not require a round-trip to object storage, but may
303
+ # not see the latest writes.
304
304
  sig do
305
- override.returns(
306
- T::Array[
307
- Turbopuffer::NamespaceQueryParams::Consistency::Level::TaggedSymbol
308
- ]
305
+ params(max_staleness_seconds: Integer, level: Symbol).returns(
306
+ T.attached_class
309
307
  )
310
308
  end
311
- def self.values
309
+ def self.new(
310
+ # How long the query may reuse the node's cached view of the namespace before
311
+ # refreshing it from object storage. Defaults to 60.
312
+ max_staleness_seconds: nil,
313
+ level: :eventual
314
+ )
315
+ end
316
+
317
+ sig do
318
+ override.returns({ level: Symbol, max_staleness_seconds: Integer })
319
+ end
320
+ def to_hash
312
321
  end
313
322
  end
323
+
324
+ sig do
325
+ override.returns(
326
+ T::Array[Turbopuffer::NamespaceQueryParams::Consistency::Variants]
327
+ )
328
+ end
329
+ def self.variants
330
+ end
314
331
  end
315
332
 
316
333
  # Limits the documents returned by a query.
@@ -73,7 +73,10 @@ module Turbopuffer
73
73
  aggregate_by: T::Hash[Symbol, T.anything],
74
74
  compute_attributes: T::Hash[Symbol, T.anything],
75
75
  consistency:
76
- Turbopuffer::NamespaceExplainQueryParams::Consistency::OrHash,
76
+ T.any(
77
+ Turbopuffer::NamespaceExplainQueryParams::Consistency::Strong::OrHash,
78
+ Turbopuffer::NamespaceExplainQueryParams::Consistency::Eventual::OrHash
79
+ ),
77
80
  distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
78
81
  exclude_attributes: T::Array[String],
79
82
  filters: T.anything,
@@ -162,7 +165,10 @@ module Turbopuffer
162
165
  T::Array[Turbopuffer::NamespaceMultiQueryParams::Query::OrHash],
163
166
  namespace: String,
164
167
  consistency:
165
- Turbopuffer::NamespaceMultiQueryParams::Consistency::OrHash,
168
+ T.any(
169
+ Turbopuffer::NamespaceMultiQueryParams::Consistency::Strong::OrHash,
170
+ Turbopuffer::NamespaceMultiQueryParams::Consistency::Eventual::OrHash
171
+ ),
166
172
  limit: T.any(Integer, Turbopuffer::RerankLimit::OrHash),
167
173
  offset: Integer,
168
174
  rerank_by: T.anything,
@@ -214,7 +220,11 @@ module Turbopuffer
214
220
  namespace: T.nilable(String),
215
221
  aggregate_by: T::Hash[Symbol, T.anything],
216
222
  compute_attributes: T::Hash[Symbol, T.anything],
217
- consistency: Turbopuffer::NamespaceQueryParams::Consistency::OrHash,
223
+ consistency:
224
+ T.any(
225
+ Turbopuffer::NamespaceQueryParams::Consistency::Strong::OrHash,
226
+ Turbopuffer::NamespaceQueryParams::Consistency::Eventual::OrHash
227
+ ),
218
228
  distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
219
229
  exclude_attributes: T::Array[String],
220
230
  filters: T.anything,
@@ -8,6 +8,8 @@ module Turbopuffer
8
8
 
9
9
  DEFAULT_MAX_RETRY_DELAY: Float
10
10
 
11
+ DEFAULT_MAX_CONNECTIONS: Integer
12
+
11
13
  attr_reader api_key: String
12
14
 
13
15
  attr_reader region: String?
@@ -37,7 +39,8 @@ module Turbopuffer
37
39
  ?max_retries: Integer,
38
40
  ?timeout: Float,
39
41
  ?initial_retry_delay: Float,
40
- ?max_retry_delay: Float
42
+ ?max_retry_delay: Float,
43
+ ?max_connections: Integer
41
44
  ) -> void
42
45
  end
43
46
  end
@@ -4,6 +4,11 @@ module Turbopuffer
4
4
  ENV_VAR: String
5
5
  HEADER: String
6
6
  SAMPLE_RATE_HEADER: String
7
+ REQUEST_ID_ALPHABET: String
8
+ REQUEST_ID_BYTES: Integer
9
+ REQUEST_ID_HEADER: String
10
+ REQUEST_ID_PREFIX: String
11
+ REQUEST_ID_RANDOM_BYTES: Integer
7
12
 
8
13
  ENVELOPE_VERSION: Integer
9
14
 
@@ -31,6 +36,10 @@ module Turbopuffer
31
36
 
32
37
  def self.random: -> Float
33
38
 
39
+ def self.encode_base32: (String bytes) -> String
40
+
41
+ def self.new_request_id: (Time now, ?random: String) -> String
42
+
34
43
  def self.buffer_for: (
35
44
  bool? enabled,
36
45
  String api_key,
@@ -61,15 +70,19 @@ module Turbopuffer
61
70
 
62
71
  def observe_response: (top response) -> void
63
72
 
73
+ def sample: -> Float?
74
+
64
75
  def record: (
65
76
  method: Symbol | String,
66
77
  url: URI::Generic | String,
67
78
  status: Integer,
68
79
  retries: Integer,
69
80
  durations: ::Hash[Symbol, Integer],
81
+ sample_rate: Float,
70
82
  ?server_total_ms: Numeric?,
71
83
  ?error: String?,
72
- ?reused: bool?
84
+ ?reused: bool?,
85
+ ?request_id: String?
73
86
  ) -> void
74
87
 
75
88
  def take: -> Turbopuffer::Internal::Telemetry::Batch?
@@ -66,6 +66,8 @@ module Turbopuffer
66
66
 
67
67
  attr_reader max_retry_delay: Float
68
68
 
69
+ attr_reader max_connections: Integer
70
+
69
71
  attr_reader headers: ::Hash[String, String]
70
72
 
71
73
  attr_reader idempotency_header: String?
@@ -82,6 +84,7 @@ module Turbopuffer
82
84
  ?max_retries: Integer,
83
85
  ?initial_retry_delay: Float,
84
86
  ?max_retry_delay: Float,
87
+ ?max_connections: Integer,
85
88
  ?headers: ::Hash[String, (String
86
89
  | Integer
87
90
  | ::Array[(String | Integer)?])?],
@@ -7,16 +7,35 @@ module Turbopuffer
7
7
  module Encryption
8
8
  extend Turbopuffer::Internal::Type::Union
9
9
 
10
- type customer_managed = { key_name: String, mode: :"customer-managed" }
10
+ type customer_managed =
11
+ {
12
+ key_name: String,
13
+ mode: :"customer-managed",
14
+ encryption_context: ::Hash[Symbol, String]
15
+ }
11
16
 
12
17
  class CustomerManaged < Turbopuffer::Internal::Type::BaseModel
13
18
  attr_accessor key_name: String
14
19
 
15
20
  attr_accessor mode: :"customer-managed"
16
21
 
17
- def initialize: (key_name: String, ?mode: :"customer-managed") -> void
22
+ attr_reader encryption_context: ::Hash[Symbol, String]?
18
23
 
19
- def to_hash: -> { key_name: String, mode: :"customer-managed" }
24
+ def encryption_context=: (
25
+ ::Hash[Symbol, String]
26
+ ) -> ::Hash[Symbol, String]
27
+
28
+ def initialize: (
29
+ key_name: String,
30
+ ?encryption_context: ::Hash[Symbol, String],
31
+ ?mode: :"customer-managed"
32
+ ) -> void
33
+
34
+ def to_hash: -> {
35
+ key_name: String,
36
+ mode: :"customer-managed",
37
+ encryption_context: ::Hash[Symbol, String]
38
+ }
20
39
  end
21
40
 
22
41
  type default = { mode: :default }
@@ -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::NamespaceExplainQueryParams::Consistency,
8
+ consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
9
9
  distance_metric: Turbopuffer::Models::distance_metric,
10
10
  exclude_attributes: ::Array[String],
11
11
  filters: top,
@@ -35,11 +35,11 @@ module Turbopuffer
35
35
 
36
36
  def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
37
37
 
38
- attr_reader consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency?
38
+ attr_reader consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency?
39
39
 
40
40
  def consistency=: (
41
- Turbopuffer::NamespaceExplainQueryParams::Consistency
42
- ) -> Turbopuffer::NamespaceExplainQueryParams::Consistency
41
+ Turbopuffer::Models::NamespaceExplainQueryParams::consistency
42
+ ) -> Turbopuffer::Models::NamespaceExplainQueryParams::consistency
43
43
 
44
44
  attr_reader distance_metric: Turbopuffer::Models::distance_metric?
45
45
 
@@ -93,7 +93,7 @@ module Turbopuffer
93
93
  ?namespace: String,
94
94
  ?aggregate_by: ::Hash[Symbol, top],
95
95
  ?compute_attributes: ::Hash[Symbol, top],
96
- ?consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
96
+ ?consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
97
97
  ?distance_metric: Turbopuffer::Models::distance_metric,
98
98
  ?exclude_attributes: ::Array[String],
99
99
  ?filters: top,
@@ -111,7 +111,7 @@ module Turbopuffer
111
111
  namespace: String,
112
112
  aggregate_by: ::Hash[Symbol, top],
113
113
  compute_attributes: ::Hash[Symbol, top],
114
- consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
114
+ consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
115
115
  distance_metric: Turbopuffer::Models::distance_metric,
116
116
  exclude_attributes: ::Array[String],
117
117
  filters: top,
@@ -126,38 +126,40 @@ module Turbopuffer
126
126
  }
127
127
 
128
128
  type consistency =
129
- {
130
- level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
131
- }
129
+ Turbopuffer::NamespaceExplainQueryParams::Consistency::Strong
130
+ | Turbopuffer::NamespaceExplainQueryParams::Consistency::Eventual
132
131
 
133
- class Consistency < Turbopuffer::Internal::Type::BaseModel
134
- attr_reader level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level?
132
+ module Consistency
133
+ extend Turbopuffer::Internal::Type::Union
134
+
135
+ type strong = { level: :strong }
135
136
 
136
- def level=: (
137
- Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
138
- ) -> Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
137
+ class Strong < Turbopuffer::Internal::Type::BaseModel
138
+ attr_accessor level: :strong
139
139
 
140
- def initialize: (
141
- ?level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
142
- ) -> void
140
+ def initialize: (?level: :strong) -> void
143
141
 
144
- def to_hash: -> {
145
- level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
146
- }
142
+ def to_hash: -> { level: :strong }
143
+ end
147
144
 
148
- type level = :strong | :eventual
145
+ type eventual = { level: :eventual, max_staleness_seconds: Integer }
149
146
 
150
- module Level
151
- extend Turbopuffer::Internal::Type::Enum
147
+ class Eventual < Turbopuffer::Internal::Type::BaseModel
148
+ attr_accessor level: :eventual
152
149
 
153
- # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
154
- STRONG: :strong
150
+ attr_reader max_staleness_seconds: Integer?
155
151
 
156
- # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
157
- EVENTUAL: :eventual
152
+ def max_staleness_seconds=: (Integer) -> Integer
158
153
 
159
- def self?.values: -> ::Array[Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level]
154
+ def initialize: (
155
+ ?max_staleness_seconds: Integer,
156
+ ?level: :eventual
157
+ ) -> void
158
+
159
+ def to_hash: -> { level: :eventual, max_staleness_seconds: Integer }
160
160
  end
161
+
162
+ def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceExplainQueryParams::consistency]
161
163
  end
162
164
 
163
165
  type limit = Integer | Turbopuffer::Limit
@@ -4,7 +4,7 @@ module Turbopuffer
4
4
  {
5
5
  namespace: String,
6
6
  queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
7
- consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
7
+ consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
8
8
  limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
9
9
  offset: Integer,
10
10
  rerank_by: top,
@@ -22,11 +22,11 @@ module Turbopuffer
22
22
 
23
23
  attr_accessor queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query]
24
24
 
25
- attr_reader consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency?
25
+ attr_reader consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency?
26
26
 
27
27
  def consistency=: (
28
- Turbopuffer::NamespaceMultiQueryParams::Consistency
29
- ) -> Turbopuffer::NamespaceMultiQueryParams::Consistency
28
+ Turbopuffer::Models::NamespaceMultiQueryParams::consistency
29
+ ) -> Turbopuffer::Models::NamespaceMultiQueryParams::consistency
30
30
 
31
31
  attr_reader limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit?
32
32
 
@@ -51,7 +51,7 @@ module Turbopuffer
51
51
  def initialize: (
52
52
  queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
53
53
  ?namespace: String,
54
- ?consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
54
+ ?consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
55
55
  ?limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
56
56
  ?offset: Integer,
57
57
  ?rerank_by: top,
@@ -62,7 +62,7 @@ module Turbopuffer
62
62
  def to_hash: -> {
63
63
  namespace: String,
64
64
  queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
65
- consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
65
+ consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
66
66
  limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
67
67
  offset: Integer,
68
68
  rerank_by: top,
@@ -174,38 +174,40 @@ module Turbopuffer
174
174
  end
175
175
 
176
176
  type consistency =
177
- {
178
- level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
179
- }
177
+ Turbopuffer::NamespaceMultiQueryParams::Consistency::Strong
178
+ | Turbopuffer::NamespaceMultiQueryParams::Consistency::Eventual
180
179
 
181
- class Consistency < Turbopuffer::Internal::Type::BaseModel
182
- attr_reader level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level?
180
+ module Consistency
181
+ extend Turbopuffer::Internal::Type::Union
183
182
 
184
- def level=: (
185
- Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
186
- ) -> Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
183
+ type strong = { level: :strong }
187
184
 
188
- def initialize: (
189
- ?level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
190
- ) -> void
185
+ class Strong < Turbopuffer::Internal::Type::BaseModel
186
+ attr_accessor level: :strong
191
187
 
192
- def to_hash: -> {
193
- level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
194
- }
188
+ def initialize: (?level: :strong) -> void
189
+
190
+ def to_hash: -> { level: :strong }
191
+ end
195
192
 
196
- type level = :strong | :eventual
193
+ type eventual = { level: :eventual, max_staleness_seconds: Integer }
197
194
 
198
- module Level
199
- extend Turbopuffer::Internal::Type::Enum
195
+ class Eventual < Turbopuffer::Internal::Type::BaseModel
196
+ attr_accessor level: :eventual
200
197
 
201
- # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
202
- STRONG: :strong
198
+ attr_reader max_staleness_seconds: Integer?
203
199
 
204
- # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
205
- EVENTUAL: :eventual
200
+ def max_staleness_seconds=: (Integer) -> Integer
206
201
 
207
- def self?.values: -> ::Array[Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level]
202
+ def initialize: (
203
+ ?max_staleness_seconds: Integer,
204
+ ?level: :eventual
205
+ ) -> void
206
+
207
+ def to_hash: -> { level: :eventual, max_staleness_seconds: Integer }
208
208
  end
209
+
210
+ def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceMultiQueryParams::consistency]
209
211
  end
210
212
 
211
213
  type limit = Integer | Turbopuffer::RerankLimit