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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +19 -0
- data/README.md +15 -1
- data/lib/turbopuffer/client.rb +7 -0
- data/lib/turbopuffer/internal/respond_async.rb +1 -1
- data/lib/turbopuffer/internal/telemetry.rb +538 -0
- data/lib/turbopuffer/internal/transport/base_client.rb +50 -21
- data/lib/turbopuffer/internal/transport/pooled_net_requester.rb +77 -2
- data/lib/turbopuffer/internal/transport/request_observer.rb +377 -0
- data/lib/turbopuffer/models/attribute_schema_config.rb +1 -0
- data/lib/turbopuffer/models/branch_from_namespace_params.rb +3 -0
- data/lib/turbopuffer/models/copy_from_namespace_operation.rb +8 -1
- data/lib/turbopuffer/models/copy_from_namespace_operation_result.rb +5 -3
- data/lib/turbopuffer/models/copy_from_namespace_params.rb +3 -0
- data/lib/turbopuffer/models/encryption.rb +11 -1
- data/lib/turbopuffer/models/full_text_search.rb +1 -0
- data/lib/turbopuffer/models/id.rb +1 -1
- data/lib/turbopuffer/models/namespace_explain_query_params.rb +50 -24
- data/lib/turbopuffer/models/namespace_hint_cache_warm_response.rb +2 -1
- data/lib/turbopuffer/models/namespace_metadata.rb +10 -1
- data/lib/turbopuffer/models/namespace_metadata_patch.rb +1 -0
- data/lib/turbopuffer/models/namespace_multi_query_params.rb +51 -24
- data/lib/turbopuffer/models/namespace_multi_query_response.rb +19 -2
- data/lib/turbopuffer/models/namespace_query_params.rb +50 -24
- data/lib/turbopuffer/models/namespace_query_response.rb +10 -2
- data/lib/turbopuffer/models/namespace_recall_response.rb +5 -0
- data/lib/turbopuffer/models/namespace_start_copy_from_response.rb +2 -0
- data/lib/turbopuffer/models/namespace_write_params.rb +3 -3
- data/lib/turbopuffer/models/operation_error.rb +2 -0
- data/lib/turbopuffer/models/write_result.rb +1 -1
- data/lib/turbopuffer/resources/namespaces.rb +4 -4
- data/lib/turbopuffer/version.rb +1 -1
- data/lib/turbopuffer.rb +2 -0
- data/rbi/turbopuffer/client.rbi +5 -0
- data/rbi/turbopuffer/internal/telemetry.rbi +315 -0
- data/rbi/turbopuffer/internal/transport/base_client.rbi +13 -2
- data/rbi/turbopuffer/internal/transport/pooled_net_requester.rbi +47 -1
- data/rbi/turbopuffer/internal/transport/request_observer.rbi +340 -0
- data/rbi/turbopuffer/models/branch_from_namespace_params.rbi +1 -0
- data/rbi/turbopuffer/models/copy_from_namespace_operation.rbi +4 -0
- data/rbi/turbopuffer/models/copy_from_namespace_operation_result.rbi +8 -3
- data/rbi/turbopuffer/models/copy_from_namespace_params.rbi +1 -0
- data/rbi/turbopuffer/models/encryption.rbi +29 -2
- data/rbi/turbopuffer/models/namespace_explain_query_params.rbi +84 -71
- data/rbi/turbopuffer/models/namespace_hint_cache_warm_response.rbi +2 -0
- data/rbi/turbopuffer/models/namespace_metadata.rbi +5 -0
- data/rbi/turbopuffer/models/namespace_multi_query_params.rbi +86 -71
- data/rbi/turbopuffer/models/namespace_multi_query_response.rbi +17 -1
- data/rbi/turbopuffer/models/namespace_query_params.rbi +88 -71
- data/rbi/turbopuffer/models/namespace_query_response.rbi +8 -1
- data/rbi/turbopuffer/models/namespace_recall_response.rbi +4 -0
- data/rbi/turbopuffer/models/namespace_start_copy_from_response.rbi +1 -0
- data/rbi/turbopuffer/models/namespace_write_params.rbi +3 -3
- data/rbi/turbopuffer/models/operation_error.rbi +1 -0
- data/rbi/turbopuffer/models/write_result.rbi +1 -1
- data/rbi/turbopuffer/resources/namespaces.rbi +15 -4
- data/sig/turbopuffer/client.rbs +1 -0
- data/sig/turbopuffer/internal/telemetry.rbs +142 -0
- data/sig/turbopuffer/internal/transport/base_client.rbs +5 -1
- data/sig/turbopuffer/internal/transport/pooled_net_requester.rbs +15 -1
- data/sig/turbopuffer/internal/transport/request_observer.rbs +153 -0
- data/sig/turbopuffer/models/encryption.rbs +22 -3
- data/sig/turbopuffer/models/namespace_explain_query_params.rbs +30 -28
- data/sig/turbopuffer/models/namespace_multi_query_params.rbs +30 -28
- data/sig/turbopuffer/models/namespace_query_params.rbs +30 -26
- data/sig/turbopuffer/resources/namespaces.rbs +3 -3
- metadata +9 -3
data/sig/turbopuffer/client.rbs
CHANGED
|
@@ -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 =
|
|
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
|
-
|
|
22
|
+
attr_reader encryption_context: ::Hash[Symbol, String]?
|
|
18
23
|
|
|
19
|
-
def
|
|
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::
|
|
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::
|
|
38
|
+
attr_reader consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency?
|
|
39
39
|
|
|
40
40
|
def consistency=: (
|
|
41
|
-
Turbopuffer::NamespaceExplainQueryParams::
|
|
42
|
-
) -> Turbopuffer::NamespaceExplainQueryParams::
|
|
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::
|
|
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::
|
|
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
|
-
|
|
131
|
-
}
|
|
129
|
+
Turbopuffer::NamespaceExplainQueryParams::Consistency::Strong
|
|
130
|
+
| Turbopuffer::NamespaceExplainQueryParams::Consistency::Eventual
|
|
132
131
|
|
|
133
|
-
|
|
134
|
-
|
|
132
|
+
module Consistency
|
|
133
|
+
extend Turbopuffer::Internal::Type::Union
|
|
134
|
+
|
|
135
|
+
type strong = { level: :strong }
|
|
135
136
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
) -> Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
|
|
137
|
+
class Strong < Turbopuffer::Internal::Type::BaseModel
|
|
138
|
+
attr_accessor level: :strong
|
|
139
139
|
|
|
140
|
-
|
|
141
|
-
?level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
|
|
142
|
-
) -> void
|
|
140
|
+
def initialize: (?level: :strong) -> void
|
|
143
141
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
}
|
|
142
|
+
def to_hash: -> { level: :strong }
|
|
143
|
+
end
|
|
147
144
|
|
|
148
|
-
type
|
|
145
|
+
type eventual = { level: :eventual, max_staleness_seconds: Integer }
|
|
149
146
|
|
|
150
|
-
|
|
151
|
-
|
|
147
|
+
class Eventual < Turbopuffer::Internal::Type::BaseModel
|
|
148
|
+
attr_accessor level: :eventual
|
|
152
149
|
|
|
153
|
-
|
|
154
|
-
STRONG: :strong
|
|
150
|
+
attr_reader max_staleness_seconds: Integer?
|
|
155
151
|
|
|
156
|
-
|
|
157
|
-
EVENTUAL: :eventual
|
|
152
|
+
def max_staleness_seconds=: (Integer) -> Integer
|
|
158
153
|
|
|
159
|
-
def
|
|
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::
|
|
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::
|
|
25
|
+
attr_reader consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency?
|
|
26
26
|
|
|
27
27
|
def consistency=: (
|
|
28
|
-
Turbopuffer::NamespaceMultiQueryParams::
|
|
29
|
-
) -> Turbopuffer::NamespaceMultiQueryParams::
|
|
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::
|
|
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::
|
|
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
|
-
|
|
179
|
-
}
|
|
177
|
+
Turbopuffer::NamespaceMultiQueryParams::Consistency::Strong
|
|
178
|
+
| Turbopuffer::NamespaceMultiQueryParams::Consistency::Eventual
|
|
180
179
|
|
|
181
|
-
|
|
182
|
-
|
|
180
|
+
module Consistency
|
|
181
|
+
extend Turbopuffer::Internal::Type::Union
|
|
183
182
|
|
|
184
|
-
|
|
185
|
-
Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
|
|
186
|
-
) -> Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
|
|
183
|
+
type strong = { level: :strong }
|
|
187
184
|
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
) -> void
|
|
185
|
+
class Strong < Turbopuffer::Internal::Type::BaseModel
|
|
186
|
+
attr_accessor level: :strong
|
|
191
187
|
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
188
|
+
def initialize: (?level: :strong) -> void
|
|
189
|
+
|
|
190
|
+
def to_hash: -> { level: :strong }
|
|
191
|
+
end
|
|
195
192
|
|
|
196
|
-
type
|
|
193
|
+
type eventual = { level: :eventual, max_staleness_seconds: Integer }
|
|
197
194
|
|
|
198
|
-
|
|
199
|
-
|
|
195
|
+
class Eventual < Turbopuffer::Internal::Type::BaseModel
|
|
196
|
+
attr_accessor level: :eventual
|
|
200
197
|
|
|
201
|
-
|
|
202
|
-
STRONG: :strong
|
|
198
|
+
attr_reader max_staleness_seconds: Integer?
|
|
203
199
|
|
|
204
|
-
|
|
205
|
-
EVENTUAL: :eventual
|
|
200
|
+
def max_staleness_seconds=: (Integer) -> Integer
|
|
206
201
|
|
|
207
|
-
def
|
|
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
|