turbopuffer 2.8.0 → 2.10.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 (67) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +19 -0
  3. data/README.md +15 -1
  4. data/lib/turbopuffer/client.rb +7 -0
  5. data/lib/turbopuffer/internal/respond_async.rb +1 -1
  6. data/lib/turbopuffer/internal/telemetry.rb +538 -0
  7. data/lib/turbopuffer/internal/transport/base_client.rb +50 -21
  8. data/lib/turbopuffer/internal/transport/pooled_net_requester.rb +77 -2
  9. data/lib/turbopuffer/internal/transport/request_observer.rb +377 -0
  10. data/lib/turbopuffer/models/attribute_schema_config.rb +1 -0
  11. data/lib/turbopuffer/models/branch_from_namespace_params.rb +3 -0
  12. data/lib/turbopuffer/models/copy_from_namespace_operation.rb +8 -1
  13. data/lib/turbopuffer/models/copy_from_namespace_operation_result.rb +5 -3
  14. data/lib/turbopuffer/models/copy_from_namespace_params.rb +3 -0
  15. data/lib/turbopuffer/models/encryption.rb +11 -1
  16. data/lib/turbopuffer/models/full_text_search.rb +1 -0
  17. data/lib/turbopuffer/models/id.rb +1 -1
  18. data/lib/turbopuffer/models/namespace_explain_query_params.rb +50 -24
  19. data/lib/turbopuffer/models/namespace_hint_cache_warm_response.rb +2 -1
  20. data/lib/turbopuffer/models/namespace_metadata.rb +10 -1
  21. data/lib/turbopuffer/models/namespace_metadata_patch.rb +1 -0
  22. data/lib/turbopuffer/models/namespace_multi_query_params.rb +51 -24
  23. data/lib/turbopuffer/models/namespace_multi_query_response.rb +19 -2
  24. data/lib/turbopuffer/models/namespace_query_params.rb +50 -24
  25. data/lib/turbopuffer/models/namespace_query_response.rb +10 -2
  26. data/lib/turbopuffer/models/namespace_recall_response.rb +5 -0
  27. data/lib/turbopuffer/models/namespace_start_copy_from_response.rb +2 -0
  28. data/lib/turbopuffer/models/namespace_write_params.rb +3 -3
  29. data/lib/turbopuffer/models/operation_error.rb +2 -0
  30. data/lib/turbopuffer/models/write_result.rb +1 -1
  31. data/lib/turbopuffer/resources/namespaces.rb +4 -4
  32. data/lib/turbopuffer/version.rb +1 -1
  33. data/lib/turbopuffer.rb +2 -0
  34. data/rbi/turbopuffer/client.rbi +5 -0
  35. data/rbi/turbopuffer/internal/telemetry.rbi +315 -0
  36. data/rbi/turbopuffer/internal/transport/base_client.rbi +13 -2
  37. data/rbi/turbopuffer/internal/transport/pooled_net_requester.rbi +47 -1
  38. data/rbi/turbopuffer/internal/transport/request_observer.rbi +340 -0
  39. data/rbi/turbopuffer/models/branch_from_namespace_params.rbi +1 -0
  40. data/rbi/turbopuffer/models/copy_from_namespace_operation.rbi +4 -0
  41. data/rbi/turbopuffer/models/copy_from_namespace_operation_result.rbi +8 -3
  42. data/rbi/turbopuffer/models/copy_from_namespace_params.rbi +1 -0
  43. data/rbi/turbopuffer/models/encryption.rbi +29 -2
  44. data/rbi/turbopuffer/models/namespace_explain_query_params.rbi +84 -71
  45. data/rbi/turbopuffer/models/namespace_hint_cache_warm_response.rbi +2 -0
  46. data/rbi/turbopuffer/models/namespace_metadata.rbi +5 -0
  47. data/rbi/turbopuffer/models/namespace_multi_query_params.rbi +86 -71
  48. data/rbi/turbopuffer/models/namespace_multi_query_response.rbi +17 -1
  49. data/rbi/turbopuffer/models/namespace_query_params.rbi +88 -71
  50. data/rbi/turbopuffer/models/namespace_query_response.rbi +8 -1
  51. data/rbi/turbopuffer/models/namespace_recall_response.rbi +4 -0
  52. data/rbi/turbopuffer/models/namespace_start_copy_from_response.rbi +1 -0
  53. data/rbi/turbopuffer/models/namespace_write_params.rbi +3 -3
  54. data/rbi/turbopuffer/models/operation_error.rbi +1 -0
  55. data/rbi/turbopuffer/models/write_result.rbi +1 -1
  56. data/rbi/turbopuffer/resources/namespaces.rbi +15 -4
  57. data/sig/turbopuffer/client.rbs +1 -0
  58. data/sig/turbopuffer/internal/telemetry.rbs +142 -0
  59. data/sig/turbopuffer/internal/transport/base_client.rbs +5 -1
  60. data/sig/turbopuffer/internal/transport/pooled_net_requester.rbs +15 -1
  61. data/sig/turbopuffer/internal/transport/request_observer.rbs +153 -0
  62. data/sig/turbopuffer/models/encryption.rbs +22 -3
  63. data/sig/turbopuffer/models/namespace_explain_query_params.rbs +30 -28
  64. data/sig/turbopuffer/models/namespace_multi_query_params.rbs +30 -28
  65. data/sig/turbopuffer/models/namespace_query_params.rbs +30 -26
  66. data/sig/turbopuffer/resources/namespaces.rbs +3 -3
  67. metadata +9 -3
@@ -33,6 +33,7 @@ module Turbopuffer
33
33
  ?default_namespace: String?,
34
34
  ?base_url: String?,
35
35
  ?compression: bool,
36
+ ?telemetry: bool?,
36
37
  ?max_retries: Integer,
37
38
  ?timeout: Float,
38
39
  ?initial_retry_delay: Float,
@@ -0,0 +1,142 @@
1
+ module Turbopuffer
2
+ module Internal
3
+ module Telemetry
4
+ ENV_VAR: String
5
+ HEADER: String
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
12
+
13
+ ENVELOPE_VERSION: Integer
14
+
15
+ MAX_RECORDS_PER_HEADER: Integer
16
+ MAX_BUFFERED_RECORDS: Integer
17
+
18
+ TRUE_VALUES: ::Array[String]
19
+ FALSE_VALUES: ::Array[String]
20
+
21
+ NAMESPACE_RE: Regexp
22
+ OPERATION_RE: Regexp
23
+ SCHEME_AND_HOST_RE: Regexp
24
+
25
+ def self.resolve_enabled: (bool? value) -> bool
26
+
27
+ def self.route_template: (
28
+ Symbol | String method,
29
+ URI::Generic | String url
30
+ ) -> String
31
+
32
+ def self.compute_durations: (
33
+ Turbopuffer::Internal::Transport::RequestObserver::Timings timings,
34
+ Integer end_at
35
+ ) -> ::Hash[Symbol, Integer]
36
+
37
+ def self.random: -> Float
38
+
39
+ def self.encode_base32: (String bytes) -> String
40
+
41
+ def self.new_request_id: (Time now, ?random: String) -> String
42
+
43
+ def self.buffer_for: (
44
+ bool? enabled,
45
+ String api_key,
46
+ String base_url
47
+ ) -> Turbopuffer::Internal::Telemetry::Buffer?
48
+
49
+ def self.after_fork_in_child: -> void
50
+
51
+ private def self.install_fork_hook: -> void
52
+
53
+ class Batch
54
+ attr_reader records: ::Array[[Integer, ::Hash[Symbol, top]]]
55
+
56
+ attr_reader dropped: Integer
57
+
58
+ attr_reader header: String
59
+
60
+ def initialize: (
61
+ ::Array[[Integer, ::Hash[Symbol, top]]] records,
62
+ Integer dropped
63
+ ) -> void
64
+ end
65
+
66
+ class Buffer
67
+ attr_reader sample_rate: Float
68
+
69
+ def initialize: -> void
70
+
71
+ def observe_response: (top response) -> void
72
+
73
+ def sample: -> Float?
74
+
75
+ def record: (
76
+ method: Symbol | String,
77
+ url: URI::Generic | String,
78
+ status: Integer,
79
+ retries: Integer,
80
+ durations: ::Hash[Symbol, Integer],
81
+ sample_rate: Float,
82
+ ?server_total_ms: Numeric?,
83
+ ?error: String?,
84
+ ?reused: bool?,
85
+ ?request_id: String?
86
+ ) -> void
87
+
88
+ def take: -> Turbopuffer::Internal::Telemetry::Batch?
89
+
90
+ def restore: (Turbopuffer::Internal::Telemetry::Batch batch) -> void
91
+
92
+ def reset_after_fork: -> void
93
+ end
94
+
95
+ class Observer < Turbopuffer::Internal::Transport::RequestObserver
96
+ attr_reader buffer: Turbopuffer::Internal::Telemetry::Buffer
97
+
98
+ def initialize: (
99
+ Turbopuffer::Internal::Telemetry::Buffer buffer
100
+ ) -> void
101
+
102
+ def start: (
103
+ Turbopuffer::Internal::Transport::RequestObserver::RequestInfo info
104
+ ) -> Turbopuffer::Internal::Telemetry::Scope
105
+ end
106
+
107
+ class Scope < Turbopuffer::Internal::Transport::RequestObserver::RequestScope
108
+ def initialize: (
109
+ Turbopuffer::Internal::Telemetry::Buffer buffer,
110
+ Turbopuffer::Internal::Transport::RequestObserver::RequestInfo info
111
+ ) -> void
112
+
113
+ def attempt_begin: (
114
+ Integer attempt,
115
+ ::Hash[Symbol, top] request
116
+ ) -> void
117
+
118
+ def attempt_end: (
119
+ Turbopuffer::Internal::Transport::RequestObserver::AttemptResult result
120
+ ) -> void
121
+
122
+ def finish: (
123
+ Turbopuffer::Internal::Transport::RequestObserver::RequestResult result
124
+ ) -> void
125
+
126
+ private def status: (
127
+ Turbopuffer::Internal::Transport::RequestObserver::RequestResult result
128
+ ) -> Integer
129
+
130
+ private def error_name: (Symbol? kind) -> String?
131
+
132
+ private def server_total_ms: (top parsed) -> Numeric?
133
+
134
+ private def field: (top value, Symbol name) -> top
135
+ end
136
+
137
+ module ForkHook
138
+ def _fork: -> Integer
139
+ end
140
+ end
141
+ end
142
+ end
@@ -73,6 +73,9 @@ module Turbopuffer
73
73
  # @api private
74
74
  attr_reader requester: Turbopuffer::Internal::Transport::PooledNetRequester
75
75
 
76
+ # @api private
77
+ attr_accessor request_observer: Turbopuffer::Internal::Transport::RequestObserver?
78
+
76
79
  def initialize: (
77
80
  base_url: String,
78
81
  ?timeout: Float,
@@ -105,7 +108,8 @@ module Turbopuffer
105
108
  Turbopuffer::Internal::Transport::BaseClient::request_input request,
106
109
  redirect_count: Integer,
107
110
  retry_count: Integer,
108
- send_retry_header: bool
111
+ send_retry_header: bool,
112
+ ?observation: Turbopuffer::Internal::Transport::RequestObserver::Observation?
109
113
  ) -> [Integer, top, Enumerable[String]]
110
114
 
111
115
  def request: (
@@ -10,13 +10,22 @@ module Turbopuffer
10
10
  url: URI::Generic,
11
11
  headers: ::Hash[String, String],
12
12
  body: top,
13
- deadline: Float
13
+ deadline: Float,
14
+ timings: Turbopuffer::Internal::Transport::RequestObserver::Timings?
14
15
  }
15
16
 
16
17
  KEEP_ALIVE_TIMEOUT: 30
17
18
 
18
19
  DEFAULT_MAX_CONNECTIONS: Integer
19
20
 
21
+ module ObservedConnection
22
+ attr_accessor request_timings: Turbopuffer::Internal::Transport::RequestObserver::Timings?
23
+ end
24
+
25
+ class ObservedRequest
26
+ attr_accessor request_timings: Turbopuffer::Internal::Transport::RequestObserver::Timings?
27
+ end
28
+
20
29
  def self.connect: (
21
30
  cert_store: OpenSSL::X509::Store,
22
31
  url: URI::Generic
@@ -24,6 +33,11 @@ module Turbopuffer
24
33
 
25
34
  def self.calibrate_socket_timeout: (top conn, Float deadline) -> void
26
35
 
36
+ def self.observe_connection: (
37
+ top conn,
38
+ Turbopuffer::Internal::Transport::RequestObserver::Timings? timings
39
+ ) -> void
40
+
27
41
  def self.build_request: (
28
42
  Turbopuffer::Internal::Transport::PooledNetRequester::request request
29
43
  ) {
@@ -0,0 +1,153 @@
1
+ module Turbopuffer
2
+ module Internal
3
+ module Transport
4
+ class RequestObserver
5
+ def start: (
6
+ Turbopuffer::Internal::Transport::RequestObserver::RequestInfo info
7
+ ) -> Turbopuffer::Internal::Transport::RequestObserver::RequestScope?
8
+
9
+ class RequestScope
10
+ def attempt_begin: (
11
+ Integer attempt,
12
+ ::Hash[Symbol, top] request
13
+ ) -> void
14
+
15
+ def attempt_end: (
16
+ Turbopuffer::Internal::Transport::RequestObserver::AttemptResult result
17
+ ) -> void
18
+
19
+ def finish: (
20
+ Turbopuffer::Internal::Transport::RequestObserver::RequestResult result
21
+ ) -> void
22
+ end
23
+
24
+ class RequestInfo
25
+ attr_reader method: Symbol
26
+
27
+ attr_reader url: String
28
+
29
+ def initialize: (method: Symbol, url: String) -> void
30
+ end
31
+
32
+ class AttemptResult
33
+ attr_reader attempt: Integer
34
+
35
+ attr_reader request: ::Hash[Symbol, top]
36
+
37
+ attr_reader response: top
38
+
39
+ attr_reader error: Exception?
40
+
41
+ attr_reader error_kind: Symbol?
42
+
43
+ attr_reader reached_server: bool?
44
+
45
+ attr_reader timings: Turbopuffer::Internal::Transport::RequestObserver::Timings
46
+
47
+ def initialize: (
48
+ attempt: Integer,
49
+ request: ::Hash[Symbol, top],
50
+ response: top,
51
+ error: Exception?,
52
+ error_kind: Symbol?,
53
+ reached_server: bool?,
54
+ timings: Turbopuffer::Internal::Transport::RequestObserver::Timings
55
+ ) -> void
56
+ end
57
+
58
+ class RequestResult
59
+ attr_reader retries: Integer
60
+
61
+ attr_reader response: top
62
+
63
+ attr_reader error: Exception?
64
+
65
+ attr_reader error_kind: Symbol?
66
+
67
+ attr_reader parsed: top
68
+
69
+ attr_reader timings: Turbopuffer::Internal::Transport::RequestObserver::Timings
70
+
71
+ def initialize: (
72
+ retries: Integer,
73
+ response: top,
74
+ error: Exception?,
75
+ error_kind: Symbol?,
76
+ parsed: top,
77
+ timings: Turbopuffer::Internal::Transport::RequestObserver::Timings
78
+ ) -> void
79
+ end
80
+
81
+ class Timings
82
+ attr_accessor attempt_begin: Integer?
83
+
84
+ attr_accessor serialize_begin: Integer?
85
+
86
+ attr_accessor serialize_end: Integer?
87
+
88
+ attr_accessor request_ready: Integer?
89
+
90
+ attr_accessor connect_begin: Integer?
91
+
92
+ attr_accessor connect_end: Integer?
93
+
94
+ attr_accessor send_begin: Integer?
95
+
96
+ attr_accessor send_end: Integer?
97
+
98
+ attr_accessor response_headers: Integer?
99
+
100
+ attr_accessor body_end: Integer?
101
+
102
+ attr_accessor deserialize_begin: Integer?
103
+
104
+ attr_accessor deserialize_end: Integer?
105
+
106
+ attr_accessor reused: bool?
107
+
108
+ attr_reader extra: ::Hash[Symbol, top]
109
+
110
+ def initialize: -> void
111
+ end
112
+
113
+ CONNECT_ERRORS: ::Array[Class]
114
+
115
+ def self.now: -> Integer
116
+
117
+ def self.call_safely: (Symbol hook) { -> top } -> top
118
+
119
+ def self.error_kind: (
120
+ Exception error,
121
+ Turbopuffer::Internal::Transport::RequestObserver::Timings timings
122
+ ) -> Symbol
123
+
124
+ class Observation
125
+ def self.start: (
126
+ Turbopuffer::Internal::Transport::RequestObserver observer,
127
+ ::Hash[Symbol, top] request,
128
+ Integer started_at,
129
+ path: String
130
+ ) -> Turbopuffer::Internal::Transport::RequestObserver::Observation?
131
+
132
+ def attempt_begin: (
133
+ ::Hash[Symbol, top] input,
134
+ retry_count: Integer
135
+ ) -> ::Hash[Symbol, top]
136
+
137
+ def attempt_end: (Integer | Exception status, top response) -> void
138
+
139
+ def deserialize_begin: -> void
140
+
141
+ def finish: (?response: top, ?parsed: top, ?error: Exception?) -> void
142
+
143
+ def initialize: (
144
+ Turbopuffer::Internal::Transport::RequestObserver::RequestScope scope,
145
+ body: bool,
146
+ started_at: Integer,
147
+ built_at: Integer
148
+ ) -> void
149
+ end
150
+ end
151
+ end
152
+ end
153
+ end
@@ -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